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

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

JavaScript

fetch-trends.js

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();

Python

fetch_trends.py

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

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