Shops

Get shop social follower history

Returns follower time-series for Facebook and Instagram for the linked advertiser page of the shop. Other networks are handle-only today and not exposed here.

get/v1/shops/{shopId}/socials/history

Request

  • Base URL: https://api.trendtrack.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.trendtrack.io/v1/shops/{shopId}/socials/history
  • Auth: HTTP bearer

Path parameters

shopIdstring required
Example:3f8aa146-6f96-46e8-9781-64db5166f9a8

Stable public shop identifier.

Query parameters

period'day' | 'week' | 'month'

Aggregation bucket for the follower time series. Week and month pick the last raw snapshot of each bucket.

daysinteger

Rolling lookback window, in days, ending at the latest snapshot.

Response

Follower time-series response. The response also includes the X-Request-Id header.

requestIdstring required

Example response

{
  "requestId": "req_01JN3C9Q2K5X9Y6V7W8Z1A2B3C",
  "data": {
    "facebook": [
      {
        "period": "2026-03-01",
        "value": 2942350
      }
    ],
    "instagram": [
      {
        "period": "2026-03-01",
        "value": 2942350
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.