Top Related Trends

GET /v1/latest/{level}/related-trends/{limit}/popindex/{region}/{category_id}/{affinity_group}

Returns related trends for a category in a given region, ranked by popularity index.

Parameters

Name	Type	Required	Description
level	string	yes	Categorisation level. One of cat1, cat2, cat3, cat4, cat5.
limit	string	yes	Number of rows to return. One of top5, top100, all.
region	string	yes	Region code for the market you want data from. One of us, gb, fr, kr, jp, global.
category_id	UUID	yes	Identifier of the category you want related trends for.
affinity_group	string	no	Related group, such as ingredients or concerns.

Response

Root

Field	Type	Description
key	string	The API resource key identifying the request path.
credits_used	integer	Number of API credits consumed for the request.
data	object	Contains trend data and metadata for the category.

Data

Field	Type	Description
cat{N}_id	string	Unique identifier for the requested category level. One of cat1_id, cat2_id, cat3_id, cat4_id, or cat5_id.
dashboard	string	URL to the interactive dashboard for this category on Spate.
trends	array	Related trend items for the specified category. The number of rows depends on limit.
call_cost	integer	Credits used to make this API call.
data_cost	integer	Estimated data cost in credits.

Trends

Each item in the array represents a related trend.

Field	Type	Description
related_trend_id / cat5_id	string	Unique identifier for the related trend.
related_trend_label / cat5_label	string	Descriptive label of the related trend, e.g., “collagen” or “water”.
rank	integer	Rank among returned related trends, where 1 is highest.
life_cycle	`string	null`
popularity	number	Aggregate popularity score for the trend.
yoy_percent_increase	float	Year-over-year percentage trend change. Negative values indicate a decrease.
yoy_absolute_increase	integer	Year-over-year absolute change in popularity.
qoq_percent_increase	float	Quarter-over-quarter percentage change.
qoq_absolute_increase	integer	Quarter-over-quarter absolute change in popularity.
mom_percent_increase	float	Month-over-month percentage change.
mom_absolute_increase	integer	Month-over-month absolute change in popularity.
google_share_percent	float	Fraction of total share volume from Google.
tiktok_share_percent	float	Fraction of total share volume from TikTok.
instagram_share_percent	float	Fraction of total share volume from Instagram.

Examples

Top 5 ingredients for Beauty

Request

Terminal

curl "https://api.spate.nyc/v1/latest/cat1/related-trends/top5/popindex/us/6d408533-6979-43aa-80af-4d88bf0be860/ingredients" \
    -H "Authorization: Bearer $SPATE_API_KEY" | jq

Response

200 OK

{
  "key": "/v1/2026w21/cat1/related-trends/top5/popindex/us/6d408533-6979-43aa-80af-4d88bf0be860/ingredients",
  "credits_used": 10,
  "data": {
    "cat1_id": "6d408533-6979-43aa-80af-4d88bf0be860",
    "dashboard": "https://app.spate.nyc/explore/related-categories/trends/6d408533-6979-43aa-80af-4d88bf0be860?relatedCategories.popIndexParentName=ingredients&country=US",
    "trends": [
      {
        "cat5_id": "6dada23e-1d02-45a8-b592-6d824a56a415",
        "cat5_label": "collagen",
        "rank": 1,
        "popularity": 7374346.1659,
        "yoy_percent_increase": 0.6594,
        "yoy_absolute_increase": 2930258,
        "qoq_percent_increase": -0.1941,
        "qoq_absolute_increase": -1876140,
        "mom_percent_increase": 0.0204,
        "mom_absolute_increase": 150589,
        "google_share_percent": 0.0439,
        "tiktok_share_percent": 0.8389,
        "instagram_share_percent": 0.1172
      },
      ...
    ],
    "call_cost": 10,
    "data_cost": 50
  }
}

Top 5 ingredients for Korean Sunscreen

Request

Terminal

curl https://api.spate.nyc/v1/latest/cat5/related-trends/top5/popindex/us/0615732b-941b-4d90-9928-9bf8195015d9/ingredients \
  -H "Authorization: Bearer $SPATE_API_KEY" | jq

Response

200 OK

{
  "key": "/v1/2026w31/cat5/related-trends/top5/popindex/us/0615732b-941b-4d90-9928-9bf8195015d9/ingredients",
  "credits_used": 10,
  "data": {
    "cat5_id": "0615732b-941b-4d90-9928-9bf8195015d9",
    "dashboard": "https://app.spate.nyc/explore/related-categories/trends/0615732b-941b-4d90-9928-9bf8195015d9?relatedCategories.popIndexParentName=ingredients&country=US",
    "trends": [
      {
        "related_trend_id": "8693a056-45d5-47f4-befc-d1f975abd03e",
        "related_trend_label": "water",
        "rank": 1,
        "life_cycle": null,
        "popularity": 2876.1992,
        "yoy_percent_increase": 4.094,
        "yoy_absolute_increase": 2312,
        "qoq_percent_increase": -0.1523,
        "qoq_absolute_increase": -681,
        "mom_percent_increase": -0.0726,
        "mom_absolute_increase": -216,
        "google_share_percent": 0,
        "tiktok_share_percent": 0.917,
        "instagram_share_percent": 0.083
      },
      ...
    ],
    "call_cost": 10,
    "data_cost": 5
  }
}

Top 5 related trends for Bath & Body

Request

Terminal

curl "https://api.spate.nyc/v1/latest/cat2/related-trends/top5/popindex/us/9c36952a-6088-49a5-bd76-a65a51f1358a" \
    -H "Authorization: Bearer $SPATE_API_KEY" | jq

Response

200 OK

{
  "key": "/v1/2026w36/cat2/related-trends/top5/popindex/us/9c36952a-6088-49a5-bd76-a65a51f1358a",
  "credits_used": 60,
  "data": {
    "cat2_id": "9c36952a-6088-49a5-bd76-a65a51f1358a",
    "dashboard": "https://app.spate.nyc/explore/related-categories/trends/9c36952a-6088-49a5-bd76-a65a51f1358a?country=US",
    "trends": [
      {
        "related_trend_id": "7be9abcb-f862-4fd6-9057-fbc016649eb9",
        "related_trend_label": "body",
        "rank": 1,
        "life_cycle": null,
        "popularity": 32226442.4592,
        "yoy_percent_increase": 0.2679,
        "yoy_absolute_increase": 6809389,
        "qoq_percent_increase": 0.1361,
        "qoq_absolute_increase": 3783832,
        "mom_percent_increase": -0.1286,
        "mom_absolute_increase": -4445605,
        "yoy_percent_increase_prediction": null,
        "google_share_percent": 0.9183,
        "tiktok_share_percent": 0.0796,
        "instagram_share_percent": 0.0021,
        "cluster": null
      },
      ...
    ],
    "call_cost": 10,
    "data_cost": 50
  }
}