GET
/
stats
/
snapshots
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

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
default:05/01/2025
required

Start date in MM/DD/YYYY format

end_date
string
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.

Response

200
application/json

Snapshots retrieved successfully

The response is of type object.