Discovery

Resolve a brand, advertiser, or shop

Zero-credit lookup for brand names, shop domains, Facebook page ids, and Instagram handles. Exact matches are returned before fuzzy name matches.

get/v1/lookup

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

Query parameters

qstring required

Brand name, shop domain, Facebook page id, or Instagram handle.

type'auto' | 'brandtracker' | 'advertiser' | 'shop'

Limit lookup to one resource type, or search brandtrackers, advertisers, and shops with auto.

limitinteger

Response

Lookup results linking known brandtracker, advertiser, and shop public identifiers. 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": [
    {
      "type": "shop",
      "matchType": "exact",
      "matchField": "domain",
      "score": 1,
      "brandtracker": {
        "id": "1e08fa85-625a-4ba5-b673-d2a4b7bc7c55",
        "name": "Example Brand",
        "facebookPageId": "61554990830184"
      },
      "advertiser": {
        "id": "61554990830184",
        "name": "Example Brand",
        "facebookPageId": "61554990830184"
      },
      "shop": {
        "id": "3f8aa146-6f96-46e8-9781-64db5166f9a8",
        "domain": "examplebrand.com",
        "name": "Example Brand"
      },
      "signals": {
        "activeAds": 42,
        "liveAdsCount": 42,
        "reach30d": 152340,
        "totalReach": 842100,
        "monthlyVisits": 1200000,
        "workspaceAddedAt": "2026-04-20T12:34:56.000Z",
        "hasBrandtracker": true,
        "hasAdvertiser": true,
        "hasShop": true
      }
    }
  ],
  "meta": {
    "q": "examplebrand.com",
    "type": "auto",
    "limit": 10,
    "returned": 3,
    "partial": true,
    "warnings": [
      {
        "code": "upstream_timeout",
        "type": "advertiser",
        "message": "advertiser lookup timed out. Returned available matches from other resource types."
      }
    ]
  }
}

Changes

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