Skip to main content
GET
/
stats
/
snapshots
cURL
curl --request GET \
  --url https://api.growi.io/api/public/v1/stats/snapshots \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {}
}
Retrieves time-series data for content engagement metrics within a specified date range.

​
Request Parameters

ParameterTypeDescriptionRequiredDefault
start_dateStringStart date in MM/DD/YYYY formatYesCurrent date - 7 days
end_dateStringEnd date in MM/DD/YYYY formatYesCurrent date
limitIntegerLimit the number of results. Default is 4. Recommended is 20. Set to 10,000 to get all data.No4
campaign_idIntegerFilter 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=05/12/2025&end_date=05/22/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,
        "organization_id": null
      },
      {
        "date": "2025-05-13",
        "total_views": 638747,
        "total_likes": 20915,
        "total_comments": 581,
        "total_shares": 4037,
        "organization_id": null
      },
      {
        "date": "2025-05-14",
        "total_views": 1002978,
        "total_likes": 35385,
        "total_comments": 789,
        "total_shares": 9539,
        "organization_id": null
      }
      // 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:05/01/2025
required

Start date in MM/DD/YYYY format

​
end_date
string<date>
default:05/08/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

Snapshots retrieved successfully

​
success
boolean
Example:

true

​
data
object

Snapshots data

⌘I