Time series

GET /v1/latest/{type}/timeseries/{source}/{region}/{item_id}

Returns a time series. Pop Index series are monthly (last 36 months); TikTok series are weekly (last 156 weeks).

Instagram series are weekly likes (up to 156 weeks). Google series are monthly search volume (last 36 months).

Parameters

Name	Type	Required	Description
type	string	yes	Type of the entity. One of cat5, brand, hashtag.
source	string	yes	Data source. One of popindex, tiktok, instagram, google. See Supported combinations.
region	string	yes	Region code for the market you want data from. One of us, gb, fr, kr, jp, global.
item_id	UUID or string	yes	Identifier of the category or brand, or the hashtag itself for hashtag, URL-encoded (e.g. %23nivea for #nivea, see Find Hashtag).

Supported combinations

type \ source	popindex	tiktok	instagram	google
cat5	✓		✓	✓
brand	✓	✓	✓	✓
hashtag		✓

Examples

Cat 5 - Korean Sunscreen

Request

Terminal

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

Response

200 OK

{
  "key": "/v1/2026w24/cat5/timeseries/popindex/us/0615732b-941b-4d90-9928-9bf8195015d9",
  "credits_used": 360,
  "data": {
    "cat5_id": "0615732b-941b-4d90-9928-9bf8195015d9",
    "dashboard": "https://app.spate.nyc/categoryFive/0615732b-941b-4d90-9928-9bf8195015d9?country=US",
    "timeseries": [
      {
        "date": "2023-06-01",
        "real_volume": 2733075.654281283
      },
      ...
      {
        "date": "2026-04-01",
        "real_volume": 34227075.114174545
      }
    ],
    "call_cost": 10,
    "data_cost": 350
  }
}

Brand - L’Oréal

Request

Terminal

curl https://api.spate.nyc/v1/latest/brand/timeseries/popindex/us/cc072b84-89e2-4926-9940-368e7f222787 \
  -H "Authorization: Bearer $SPATE_API_KEY" | jq

Response

200 OK

{
  "key": "/v1/2026w24/brand/timeseries/popindex/us/cc072b84-89e2-4926-9940-368e7f222787",
  "credits_used": 360,
  "data": {
    "brand_id": "cc072b84-89e2-4926-9940-368e7f222787",
    "dashboard": "https://app.spate.nyc/brands/cc072b84-89e2-4926-9940-368e7f222787?country=US",
    "timeseries": [
      {
        "date": "2023-06-01",
        "real_volume": 740893409.0046556
      },
      ...
      {
        "date": "2026-04-01",
        "real_volume": 1024261323.6931552
      }
    ],
    "call_cost": 10,
    "data_cost": 350
  }
}

Brand - L’Oréal Paris on TikTok

Request

Terminal

curl https://api.spate.nyc/v1/latest/brand/timeseries/tiktok/us/cc072b84-89e2-4926-9940-368e7f222787 \
  -H "Authorization: Bearer $SPATE_API_KEY" | jq

Response

200 OK

{
  "key": "/v1/2026w41/brand/timeseries/tiktok/us/cc072b84-89e2-4926-9940-368e7f222787",
  "credits_used": 1570,
  "data": {
    "brand_id": "cc072b84-89e2-4926-9940-368e7f222787",
    "brand_label": "l'oréal paris",
    "dashboard": "https://app.spate.nyc/brands/cc072b84-89e2-4926-9940-368e7f222787/tiktok?country=US",
    "timeseries": [
      {
        "date": "2023-10-15",
        "real_volume": 262592334,
        "volume": 53.29
      },
      ...
      {
        "date": "2026-10-04",
        "real_volume": 441437306,
        "volume": 89.59
      }
    ],
    "call_cost": 10,
    "data_cost": 1560
  }
}

Hashtag - #nivea on TikTok

Request

Terminal

curl https://api.spate.nyc/v1/latest/hashtag/timeseries/tiktok/us/%23nivea \
  -H "Authorization: Bearer $SPATE_API_KEY" | jq

Response

200 OK

{
  "key": "/v1/2026w41/hashtag/timeseries/tiktok/us/#nivea",
  "credits_used": 322,
  "data": {
    "hashtag": "#nivea",
    "dashboard": "https://app.spate.nyc/explore/tiktok/hashtags/brands?hashtag=nivea&country=US",
    "timeseries": [
      {
        "date": "2023-10-15",
        "real_volume": 2518591,
        "volume": 33.25
      },
      ...
      {
        "date": "2026-10-04",
        "real_volume": 3237899,
        "volume": 42.75
      }
    ],
    "call_cost": 10,
    "data_cost": 312
  }
}

Brand - L’Oréal Paris on Instagram

Request

Terminal

curl https://api.spate.nyc/v1/latest/brand/timeseries/instagram/us/cc072b84-89e2-4926-9940-368e7f222787 \
  -H "Authorization: Bearer $SPATE_API_KEY" | jq

Response

200 OK

{
  "key": "/v1/2026w43/brand/timeseries/instagram/us/cc072b84-89e2-4926-9940-368e7f222787",
  "credits_used": 210,
  "data": {
    "brand_id": "cc072b84-89e2-4926-9940-368e7f222787",
    "brand_label": "l'oréal paris",
    "dashboard": "https://app.spate.nyc/brands/cc072b84-89e2-4926-9940-368e7f222787/instagram?country=US",
    "data_source": "instagram",
    "timeseries": [
      {
        "date": "2024-12-01",
        "real_volume": 136032.0
      },
      ...
      {
        "date": "2026-10-25",
        "real_volume": 291879.0
      }
    ],
    "call_cost": 10,
    "data_cost": 200
  }
}

Cat 5 - Korean Sunscreen on Google

Request

Terminal

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

Response

200 OK

{
  "key": "/v1/2026w43/cat5/timeseries/google/us/0615732b-941b-4d90-9928-9bf8195015d9",
  "credits_used": 370,
  "data": {
    "cat5_id": "0615732b-941b-4d90-9928-9bf8195015d9",
    "cat5_label": "korean sunscreen",
    "dashboard": "https://app.spate.nyc/categoryFive/0615732b-941b-4d90-9928-9bf8195015d9/google?country=US",
    "data_source": "google",
    "timeseries": [
      {
        "date": "2023-10-01",
        "real_volume": 875578.1077048426
      },
      ...
      {
        "date": "2026-09-01",
        "real_volume": 2018427.920387414
      }
    ],
    "call_cost": 10,
    "data_cost": 360
  }
}