Brandtrackers

List brandtrackers

Returns the workspace-scoped active brandtrackers attached to the authenticated public API workspace. The public identifier is brandtracker.id; legacy spyders.uuid values are accepted when migration metadata exists.

get/v1/brandtrackers

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
  • Auth: HTTP bearer

Query parameters

pageinteger
limitinteger
hasNewAdsSincestring date-time

ISO date/time lower bound. Returns brandtrackers with positive new-ad deltas recorded on or after this timestamp.

namestring

Case-insensitive contains match against brandtracker name.

sortBy'newAdsLastDay' | 'newAdsLast7Days' | 'newAdsLast30Days' | 'activeAds' | 'totalTraffic' | 'name' | 'createdAt'

Sort key. Metric and createdAt sorts are descending; name sorts ascending. Omit to preserve default workspace ordering.

folderIdsinteger[]

Folder ids. Repeated query params and comma-separated values are both accepted.

folderNamesstring[]

Folder name search terms. Matches are case-insensitive contains checks. Repeated query params and comma-separated values are both accepted.

Response

Paginated brandtrackers 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": [
    {
      "id": "1e08fa85-625a-4ba5-b673-d2a4b7bc7c55",
      "name": "Example Brand",
      "facebookPageId": "61554990830184",
      "workspaceLinkId": 99,
      "targetType": "shop",
      "websiteId": "3d6fd2f0-5b34-4ffc-91ff-f59775544e5f",
      "domain": "examplebrand.com",
      "avatarUrl": "https://medias.trendtrack.io/profile_picture/61554990830184.jpg",
      "status": {
        "isLoaded": true,
        "lastCrawledAt": "2026-04-20T10:00:00.000Z"
      },
      "workspaceAddedAt": "2026-04-15T09:00:00.000Z",
      "folder": {
        "id": 42,
        "name": "Competitors"
      },
      "advertising": {
        "activeAds": 18,
        "newAdsLastDay": 3,
        "newAdsLast7Days": 11,
        "newAdsLast30Days": 34
      },
      "websites": [
        {
          "id": "3d6fd2f0-5b34-4ffc-91ff-f59775544e5f",
          "domain": "examplebrand.com",
          "siteName": "Example Brand",
          "trafficNumber": 145230,
          "trafficChange": 12.4,
          "monthlyTraffic": {
            "2026-01": 102343,
            "2026-02": 114230
          },
          "socialNetworks": {
            "facebook": "https://facebook.com/examplebrand",
            "instagram": "https://instagram.com/examplebrand",
            "youtube": "https://youtube.com/@examplebrand"
          }
        }
      ],
      "totalTraffic": 145230
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 128,
    "totalPages": 6
  }
}

Changes

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