Skip to content
SpateSpateAPI

Brand Top Related Trends

GET /v1/latest/brand/related-trends/{limit}/{data_source}/{region}/{brand_id}

Returns related trends for a brand in a given region, ranked by the selected data source.

Parameters

Section titled “Parameters”
Name Type Required Description
limit string yes Number of rows to return. One of top5, top100, all.
data_source string yes Data source used to rank related trends. One of popindex, tiktok.
region string yes Region code for the market you want data from. One of us, gb, fr, kr, jp, global.
brand_id UUID yes Identifier of the brand you want related trends for.

Examples

Section titled “Examples”
Section titled “Top 5 related trends for l’Oréal by popularity index”

Request

Section titled “Request”
Terminal window
curl "https://api.spate.nyc/v1/latest/brand/related-trends/top5/popindex/us/cc072b84-89e2-4926-9940-368e7f222787" \
    -H "Authorization: Bearer $SPATE_API_KEY" | jq

Response

Section titled “Response”
200 OK
{
  "key": "/v1/2026w34/brand/related-trends/top5/popindex/us/cc072b84-89e2-4926-9940-368e7f222787",
  "credits_used": 60,
  "data": {
    "brand_id": "cc072b84-89e2-4926-9940-368e7f222787",
    "dashboard": "https://app.spate.nyc/brands/cc072b84-89e2-4926-9940-368e7f222787?country=US#related-categories",
    "related_trends": [
      {
        "related_trend_id": "31f878ea-acff-491f-8ec5-c03c2ffcc04d",
        "related_trend_label": "paris",
        "rank": 1,
        "life_cycle": null,
        "popularity": 11919207.4941,
        "yoy_percent_increase": 0.9329,
        "yoy_absolute_increase": 5752747,
        "qoq_percent_increase": -0.4358,
        "qoq_absolute_increase": -10377519,
        "mom_percent_increase": -0.6907,
        "mom_absolute_increase": -9778321,
        "yoy_percent_increase_prediction": null,
        "google_share_percent": 0.7539,
        "tiktok_share_percent": 0.2451,
        "instagram_share_percent": 0.0011,
        "cluster": null
      },
      ...
    ],
    "call_cost": 10,
    "data_cost": 50
  }
}
Section titled “Top 5 related trends for l’Oréal on TikTok”

Request

Section titled “Request”
Terminal window
curl "https://api.spate.nyc/v1/latest/brand/related-trends/top5/tiktok/us/cc072b84-89e2-4926-9940-368e7f222787" \
    -H "Authorization: Bearer $SPATE_API_KEY" | jq

Response

Section titled “Response”
200 OK
{
  "key": "/v1/2026w34/brand/related-trends/top5/tiktok/us/cc072b84-89e2-4926-9940-368e7f222787",
  "credits_used": 60,
  "data": {
    "brand_id": "cc072b84-89e2-4926-9940-368e7f222787",
    "dashboard": "https://app.spate.nyc/brands/cc072b84-89e2-4926-9940-368e7f222787/tiktok?country=US#related-categories",
    "related_trends": [
      {
        "related_trend_id": "f35aa7f7-fd22-464a-8322-2ff2b9d83e7a",
        "related_trend_label": "ad",
        "rank": 1,
        "life_cycle": null,
        "popularity": null,
        "yoy_percent_increase": 0.3261,
        "yoy_absolute_increase": 28186544,
        "qoq_percent_increase": -0.1678,
        "qoq_absolute_increase": -22111093,
        "mom_percent_increase": -0.1691,
        "mom_absolute_increase": -21910748,
        "yoy_percent_increase_prediction": null,
        "google_share_percent": null,
        "tiktok_share_percent": null,
        "instagram_share_percent": null,
        "cluster": null
      },
      ...
    ],
    "call_cost": 10,
    "data_cost": 50
  }
}