SOUND.RADAR API DEV
HOME Docs

Trends API

X Trends

X trending topics by WOEID, normalized into SOUND.RADAR trend endpoints.

Overview

What this API is for

This API turns public X trend signals into SOUND.RADAR snapshots by location slug or WOEID-compatible IDs.

Access

Public path and credentials

Basehttps://api.soundradar.co/x-trends
AuthProtected data endpoints require X-API-Key.
SourceCurated from public trend signals and normalized into SOUND.RADAR responses.

Endpoints

Available routes

GET/x-trends/health

Public service health and latest configured location snapshots.

GET/x-trends/locations

Supported location slugs and WOEIDs. Requires X-API-Key.

GET/x-trends/trends/{location_slug}

Latest cached trends by slug, e.g. worldwide, south-korea, seoul, tokyo.

GET/x-trends/trends/by-woeid/{woeid}

Latest cached trends by numeric WOEID.

POST/x-trends/refresh

Manually refresh one location from the configured trend source.

Examples

Requests

curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  "https://api.soundradar.co/x-trends/trends/worldwide?limit=20"
curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  "https://api.soundradar.co/x-trends/trends/by-woeid/1118370?limit=20"

Operations

Runtime notes

The X Trends channel refreshes on a scheduled cadence and publishes location-based snapshots behind the public /x-trends contract.