Posts ranked by what they gained in the range
GET
/api/public/v1/content/top_postsLiveAnswers from your brand's records now.
Operation id getContentTopPosts
Request
curl
curl "https://creator.growthdept.ai/api/public/v1/content/top_posts" \
-H "Authorization: Bearer gdc_..."Parameters
| Name | In | Type | Notes |
|---|---|---|---|
| organization_id | query | integer | |
| start_date | query | string (date) | |
| end_date | query | string (date) | |
| campaign_ids | query | string | |
| platform | query | string | One of instagramtik_tokyoutubefacebooktwitter |
| sort | query | string | One of viewslikescommentssharessavesengagement |
| limit | query | integer | |
| page | query | integer |
Responses
200Success
| Field | Type | Notes |
|---|---|---|
| data | object | |
| data.items | array of object | |
| data.items[].[].account | object | |
| data.items[].[].account.avatar_url | string, nullable | |
| data.items[].[].account.id | string | |
| data.items[].[].account.name | string, nullable | |
| data.items[].[].account.platform | string | |
| data.items[].[].account.platform_uid | string, nullable | |
| data.items[].[].account.profile_share_url | string, nullable | |
| data.items[].[].account.username | string, nullable | |
| data.items[].[].content_type | string, nullable | |
| data.items[].[].creator | object | |
| data.items[].[].creator.avatar_url | string, nullable | |
| data.items[].[].creator.id | integer | |
| data.items[].[].creator.name | string, nullable | |
| data.items[].[].external_id | string, nullable | |
| data.items[].[].id | string | |
| data.items[].[].metrics | object | |
| data.items[].[].metrics.comments | integer | |
| data.items[].[].metrics.engagement_rate | number | |
| data.items[].[].metrics.likes | integer | |
| data.items[].[].metrics.saves | integer | |
| data.items[].[].metrics.shares | integer | |
| data.items[].[].metrics.views | integer | |
| data.items[].[].platform | string | |
| data.items[].[].posted_at | string (date-time), nullable | |
| data.items[].[].share_url | string, nullable | |
| data.items[].[].title | string, nullable | |
| data.limit | integer | |
| data.min_views | integer, nullable | |
| data.page | integer | |
| data.sort | string | |
| meta | object | |
| meta.campaign_ids | array of integer | |
| meta.organization_id | integer | |
| meta.platform | string, nullable | |
| meta.scope | string | One of familybrandcampaign |
| success | boolean |
Example
{
"data": {
"items": [
{
"account": {
"avatar_url": "https://example.com/p/1",
"id": "string",
"name": "Example name",
"platform": "string",
"platform_uid": "string",
"profile_share_url": "https://example.com/p/1",
"username": "Example name"
},
"content_type": "string",
"creator": {
"avatar_url": "https://example.com/p/1",
"id": 1024,
"name": "Example name"
},
"external_id": "string",
"id": "string",
"metrics": {
"comments": 3,
"engagement_rate": 0.15,
"likes": 3,
"saves": 3,
"shares": 3,
"views": 3
},
"platform": "string",
"posted_at": "2026-11-01T15:04:05Z",
"share_url": "https://example.com/p/1",
"title": "string"
}
],
"limit": 3,
"min_views": 3,
"page": 1,
"sort": "string"
},
"meta": {
"campaign_ids": [
3
],
"organization_id": 1024,
"platform": "string",
"scope": "family"
},
"success": true
}Errors: 401404422429with an error and usually a message. See errors.
Example values are made up from each field's type and name.