Brandtrackers

Get a brandtracker

Returns the detail payload for one active workspace brandtracker resolved from brandtracker.id.

get/v1/brandtrackers/{brandtrackerId}

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

Path parameters

brandtrackerIdstring required

Example:1e08fa85-625a-4ba5-b673-d2a4b7bc7c55

Public brandtracker identifier backed by brandtracker.id. Legacy spyders.uuid values are accepted when migration metadata exists.

Response

Brandtracker detail 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,
    "createdAt": "2026-04-01T12:00:00.000Z",
    "updatedAt": "2026-04-21T09:30:00.000Z",
    "pageProfile": {
      "about": "Global fashion brand",
      "category": "Clothing (Brand)",
      "facebookLikes": 523400,
      "instagramFollowers": 841200,
      "instagramUsername": "examplebrand",
      "profileUri": "https://www.facebook.com/examplebrand",
      "runningAds": 18
    },
    "statistics": {
      "urlCount": {
        "https://examplebrand.com/products/hero": 14
      },
      "ctaCount": {
        "SHOP_NOW": 10,
        "LEARN_MORE": 4
      },
      "liveAdCount": {
        "activeCount": 18,
        "inactiveCount": 4
      },
      "formatCount": {
        "IMAGE": 8,
        "VIDEO": 10
      }
    }
  }
}

Changes

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