Brandtrackers

Get brandtracker transcripts

Returns grouped transcript/script analytics for the requested brandtracker using the authenticated workspace as the only access scope.

get/v1/brandtrackers/{brandtrackerId}/transcripts

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/brandtrackers/{brandtrackerId}/transcripts
  • Auth: HTTP bearer

Path parameters

brandtrackerIdstring required

Public brandtracker identifier. This endpoint resolves brandtracker.id inside the authenticated workspace; legacy spyders.uuid values are accepted when migration metadata exists.

Query parameters

timePeriod'live' | 'last24h' | 'last3d' | 'last7d' | 'last30d' | 'last3m' | 'last6m' | 'last1y'

Relative insights time window. Use stable windows like last7d or last30d for consistent agent behavior.

pageinteger

Pagination page number. Defaults to 1.

limitinteger

Maximum number of items to return. Defaults to 20.

euOnlyboolean

Optional EU-only filter. When true, only EU-classified Facebook ads are included.

order'asc' | 'desc'

Optional sort order. Defaults to desc.

snapshotDatestring date

Optional snapshot anchor date (YYYY-MM-DD). When provided, the requested window is evaluated against that snapshot date.

sortBy'usageCount' | 'longestRunning' | 'totalImpressions' | 'firstUsedAt' | 'lastUsedAt'

Optional transcript sorting. Defaults to usageCount.

Response

Paginated brandtracker transcripts analytics response. The response also includes the X-Request-Id header.

requestIdstring required

Request identifier mirrored in the X-Request-Id response header.

Example response

{
  "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
  "data": [
    {
      "fullText": "This is the full transcript text used by multiple ads in this brandtracker.",
      "usageCount": 12,
      "longestRunning": 47,
      "totalImpressions": 152340,
      "firstUsedAt": "2026-02-01T09:12:00.000Z",
      "lastUsedAt": "2026-04-19T12:30:00.000Z",
      "sampleAd": {
        "adId": "facebook_123456789",
        "mediaUrl": "https://cdn.example.com/ads/creative.mp4",
        "thumbnailUrl": "https://cdn.example.com/ads/creative-thumb.jpg"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 128,
    "totalPages": 7
  }
}

Changes

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