Content analytics

Creators ranked by their posts' gains in the range, or by posts

GET/api/public/v1/content/top_creators
LiveAnswers from your brand's records now.

Operation id getContentTopCreators

Request

curl

curl "https://creator.growthdept.ai/api/public/v1/content/top_creators" \
  -H "Authorization: Bearer gdc_..."

Parameters

NameInTypeNotes
organization_idqueryinteger
start_datequerystring (date)
end_datequerystring (date)
campaign_idsquerystring
platformquerystringOne of instagramtik_tokyoutubefacebooktwitter
sortquerystringOne of viewslikescommentssharessavesengagementposts
limitqueryinteger
pagequeryinteger

Responses

200Success

FieldTypeNotes
dataobject
data.itemsarray of object
data.items[].[].accountsinteger
data.items[].[].avatar_urlstring, nullable
data.items[].[].idinteger
data.items[].[].metricsobject
data.items[].[].metrics.commentsinteger
data.items[].[].metrics.engagement_ratenumber
data.items[].[].metrics.likesinteger
data.items[].[].metrics.savesinteger
data.items[].[].metrics.sharesinteger
data.items[].[].metrics.viewsinteger
data.items[].[].namestring, nullable
data.items[].[].postsinteger
data.limitinteger
data.min_viewsinteger, nullable
data.pageinteger
data.sortstring
metaobject
meta.campaign_idsarray of integer
meta.organization_idinteger
meta.platformstring, nullable
meta.scopestringOne of familybrandcampaign
successboolean

Example

{
  "data": {
    "items": [
      {
        "accounts": 3,
        "avatar_url": "https://example.com/p/1",
        "id": 1024,
        "metrics": {
          "comments": 3,
          "engagement_rate": 0.15,
          "likes": 3,
          "saves": 3,
          "shares": 3,
          "views": 3
        },
        "name": "Example name",
        "posts": 3
      }
    ],
    "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.