Posts ranked by views gained
GET
/api/public/v1/stats/top_posts_by_viewsLiveAnswers from your brand's records now.
Deprecated. It keeps working; new code should use /content/top_posts. See deprecations.
Operation id getTopPostsByViews
Request
curl
curl "https://creator.growthdept.ai/api/public/v1/stats/top_posts_by_views?start_date=2026-11-01&end_date=2026-11-01" \
-H "Authorization: Bearer gdc_..."Parameters
| Name | In | Type | Notes |
|---|---|---|---|
| start_date | query | string (date) | required Default 10/01/2025 |
| end_date | query | string (date) | required Default 11/14/2025 |
| posted_at_start_date | query | string (date) | |
| posted_at_end_date | query | string (date) | |
| limit | query | integer | Default 4 |
| page | query | integer | Default 1 |
| per_page | query | integer | Default 40 |
| include_gmv | query | boolean | Default false |
Responses
200Success
| Field | Type | Notes |
|---|---|---|
| data | object | |
| data.top_posts_by_views | array of object | |
| data.top_posts_by_views[].[].content_type | string | |
| data.top_posts_by_views[].[].external_id | string | |
| data.top_posts_by_views[].[].gmv | string | |
| data.top_posts_by_views[].[].id | integer | |
| data.top_posts_by_views[].[].metrics | object | |
| data.top_posts_by_views[].[].metrics.comments | integer | |
| data.top_posts_by_views[].[].metrics.likes | integer | |
| data.top_posts_by_views[].[].metrics.shares | integer | |
| data.top_posts_by_views[].[].metrics.views | integer | |
| data.top_posts_by_views[].[].name | string | |
| data.top_posts_by_views[].[].platform | string | |
| data.top_posts_by_views[].[].profile_share_url | string | |
| data.top_posts_by_views[].[].share_url | string | |
| data.top_posts_by_views[].[].title | string | |
| data.top_posts_by_views[].[].username | string | |
| success | boolean |
Example
{
"data": {
"top_posts_by_views": [
{
"content_type": "string",
"external_id": "string",
"gmv": "string",
"id": 1024,
"metrics": {
"comments": 3,
"likes": 3,
"shares": 3,
"views": 3
},
"name": "Example name",
"platform": "string",
"profile_share_url": "https://example.com/p/1",
"share_url": "https://example.com/p/1",
"title": "string",
"username": "Example name"
}
]
},
"success": true
}Errors: 401with an error and usually a message. See errors.
Example values are made up from each field's type and name.