Top Related Trends

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

Returns the most popular items 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`.
`limit`	`string`	yes	Number of rows to return. One of `top5, 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 trends for.
`group`	`string`	yes	Related group. Eg, `ingredients, 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 category. One of `cat1_id, cat2_id, cat3_id`
`dashboard`	`string`	URL to the interactive dashboard for this category on Spate.
`trends`	`array`	List of the top 5 trend items relating to the specified category.
`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 specific trend at the cat5 level.

Field	Type	Description
`cat5_id`	`string`	Unique identifier for the sub-category or trend.
`cat5_label`	`string`	Descriptive label of the trend, e.g., “hairstyle”, “perfume”.
`rank`	`integer`	Rank among the top 5 trends (1 = highest).
`popularity`	`integer`	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

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

const id = "6d408533-6979-43aa-80af-4d88bf0be860";
const res = await fetch(
  `https://api.spate.nyc/v1/latest/cat1/related-trends/top5/popindex/us/${id}/ingredients`,
  {
    headers: { Authorization: `Bearer ${process.env.SPATE_API_KEY}` },
  },
);

if (!res.ok) throw new Error(`Spate ${res.status}: ${await res.text()}`);
const { data } = await res.json();

import os
import requests

cat1_id = "6d408533-6979-43aa-80af-4d88bf0be860"
res = requests.get(
    f"https://api.spate.nyc/v1/latest/cat1/related-trends/top5/popindex/us/{cat1_id}/ingredients",
    headers={"Authorization": f"Bearer {os.environ['SPATE_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()
payload = res.json()

Response

{
  "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
  }
}