Stats (older)

Posts ranked by views gained

GET/api/public/v1/stats/top_posts_by_views
LiveAnswers 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

NameInTypeNotes
start_datequerystring (date)required Default 10/01/2025
end_datequerystring (date)required Default 11/14/2025
posted_at_start_datequerystring (date)
posted_at_end_datequerystring (date)
limitqueryinteger Default 4
pagequeryinteger Default 1
per_pagequeryinteger Default 40
include_gmvqueryboolean Default false

Responses

200Success

FieldTypeNotes
dataobject
data.top_posts_by_viewsarray of object
data.top_posts_by_views[].[].content_typestring
data.top_posts_by_views[].[].external_idstring
data.top_posts_by_views[].[].gmvstring
data.top_posts_by_views[].[].idinteger
data.top_posts_by_views[].[].metricsobject
data.top_posts_by_views[].[].metrics.commentsinteger
data.top_posts_by_views[].[].metrics.likesinteger
data.top_posts_by_views[].[].metrics.sharesinteger
data.top_posts_by_views[].[].metrics.viewsinteger
data.top_posts_by_views[].[].namestring
data.top_posts_by_views[].[].platformstring
data.top_posts_by_views[].[].profile_share_urlstring
data.top_posts_by_views[].[].share_urlstring
data.top_posts_by_views[].[].titlestring
data.top_posts_by_views[].[].usernamestring
successboolean

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.