Get Trending Topics
Returns the top 25 crypto narratives drawing the most attention on X,
ranked and refreshed hourly. This is the REST equivalent of the MCP
get_trending_topics tool.
No authentication is required.
Response Body
application/json
application/json
curl -X GET "https://example.com/v2/topics"{
"status": 200,
"data": {
"completedAt": "2019-08-24T14:15:22Z",
"latestEvidenceAt": "2019-08-24T14:15:22Z",
"windowStartedAt": "2019-08-24T14:15:22Z",
"topics": [
{
"id": "string",
"rank": 0,
"name": "string",
"summary": "string",
"score": 0,
"tweetCount": 0,
"authorCount": 0,
"lastSeenAt": "2019-08-24T14:15:22Z",
"clusters": [
{
"id": "string",
"name": "string",
"share": 0
}
],
"frontierReport": {
"url": "http://example.com",
"preview": "string"
}
}
]
}
}{
"error": "string",
"message": "string",
"code": "string",
"status": 0,
"data": null,
"meta": {},
"details": {},
"pagination": {
"page": 1,
"limit": 1,
"totalCount": 0,
"hasMore": true
},
"limitType": "minute",
"retryAfterMs": 0,
"limits": {
"minute": {
"limit": 0,
"remaining": 0,
"resetAt": "2019-08-24T14:15:22Z"
},
"day": {
"limit": 0,
"remaining": 0,
"resetAt": "2019-08-24T14:15:22Z"
}
},
"issues": [
{
"path": "string",
"message": "string"
}
]
}Get Topic Leaderboard History (Legacy Alias) GET
Deprecated compatibility path for paginated historical topic leaderboard snapshots. New integrations should use `GET /v2/topics`. Each snapshot contains up to 10 structured topics in attention-rank order. Supports date range filtering with `from`/`to` and anchor clamping with `at`. Requires authentication.
Get a Frontier Report GET
Returns the latest published full Frontier Report for a topic. The `id` is the topic id returned by `GET /v2/topics`. This endpoint requires an account-backed credential with Frontier Reports access.