Get Snapshots

Retrieves time-series data for content engagement metrics within a specified date range

Retrieves time-series data for content engagement metrics within a specified date range.

Response Fields

Each snapshot object contains the following fields:

Field	Type	Description
date	String	The date for this snapshot in YYYY-MM-DD format
total_views	Integer	Total number of views for all content on this date
total_likes	Integer	Total number of likes for all content on this date
total_comments	Integer	Total number of comments for all content on this date
total_shares	Integer	Total number of shares for all content on this date
total_saves	Integer	Total number of saves for all content on this date
total_posts_count	Integer	Total number of posts created on this date
user_content_ids	Array	List of user content IDs associated with this date
organization_id	Integer/null	Organization ID if applicable

Request Parameters

Parameter	Type	Description	Required	Default
start_date	String	Start date in MM/DD/YYYY format	Yes	Current date - 7 days
end_date	String	End date in MM/DD/YYYY format	Yes	Current date
limit	Integer	Limit the number of results. Default is 4. Recommended is 20. Set to 10,000 to get all data.	No	4
campaign_id	Integer	Filter snapshots by specific campaign ID. You can get campaign IDs from the Get Campaigns endpoint.	No	-

Request Example

curl -X GET "https://api.growi.io/api/public/v1/stats/snapshots?start_date=10/01/2025&end_date=11/14/2025" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"

Response Example

{
  "success": true,
  "data": {
    "snapshots": [
      {
        "date": "2025-05-12",
        "total_views": 506174,
        "total_likes": 15382,
        "total_comments": 476,
        "total_shares": 2355,
        "total_saves": 8924,
        "organization_id": null,
        "user_content_ids": [12345, 12346, 12347],
        "total_posts_count": 3
      },
      {
        "date": "2025-05-13",
        "total_views": 638747,
        "total_likes": 20915,
        "total_comments": 581,
        "total_shares": 4037,
        "total_saves": 11254,
        "organization_id": null,
        "user_content_ids": [12348, 12349],
        "total_posts_count": 2
      },
      {
        "date": "2025-05-14",
        "total_views": 1002978,
        "total_likes": 35385,
        "total_comments": 789,
        "total_shares": 9539,
        "total_saves": 19847,
        "organization_id": null,
        "user_content_ids": [12350, 12351, 12352, 12353],
        "total_posts_count": 4
      }
      // Additional daily snapshots...
    ]
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

start_date · string<date> · default: 10/01/2025 · required

Start date in MM/DD/YYYY format

end_date · string<date> · default: 11/14/2025 · required

End date in MM/DD/YYYY format

limit · integer · default: 4

Limit the number of results. Default is 4. Recommended is 20. Set to 10,000 to get all data.

campaign_id · integer

Filter snapshots by specific campaign ID. You can get campaign IDs from the Get Campaigns endpoint.

Response

200

application/json

Snapshots retrieved successfully

success · boolean

Example:

true

data · object

Snapshots data