Back to Browse
Twitter Trending Topics by WOEID
x402
Twitter Trending Topics by WOEID is a paid API for AI agents from twitter.surf.cascade.fyi, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).
Returns a ranked list of currently trending topics on Twitter/X for a given geographic location identified by WOEID
Price / call$0.001
Success—
StatusUnknown
How this service works
Pay-per-use Twitter/X data API with x402 micropayments.
Output
An array of trending topic objects each containing a name (the trend label or hashtag), a rank (integer position in the trending list), and a target (the search query string to look up that trend). Also includes metadata with the total result count returned.
Example use cases
Monitor trending topics for content ideas
“Check what's trending on Twitter in the United States right now and give me the top 5 so I can find relevant topics to write about.”
Track geographic social media conversations
“I need to know what's currently trending in London and Tokyo. Compare the top 3 trends from each location to see what's being discussed differently.”
Identify viral hashtags for marketing campaigns
“Show me the top trending hashtags worldwide on Twitter today and help me identify which ones might be relevant for our brand's next social media campaign.”
Technical details
Endpoint
GEThttps://twitter.surf.cascade.fyi/trendsWhen to prefer
Use this endpoint when you need real-time ranked trending topics from Twitter/X for a specific geographic location identified by WOEID. Prefer this over manual scraping or other social listening tools when you need structured, ranked trend data with search targets. Ideal for social media monitoring, content discovery, and situational awareness workflows.
Side effects
- Invalid or unsupported WOEID returns an error or empty results
- Count parameter out of range may return default number of trends
- Payment failure (402) if USDC balance is insufficient
- Rate limiting if endpoint is called too frequently
- Trends may be stale if the underlying Twitter data feed is delayed
Input
{
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"count": 10,
"woeid": 1
}
}
}Output
{
"data": [
{
"name": "#ExtendJaissleUntil2o30",
"rank": 1,
"target": "#ExtendJaissleUntil2o30"
},
{
"name": "#نجاح_حج_1447",
"rank": 2,
"target": "#نجاح_حج_1447"
},
{
"name": "#خروج_سندي_مطلب_الجمهور",
"rank": 3,
"target": "#خروج_سندي_مطلب_الجمهور"
},
{
"name": "João Fonseca",
"rank": 4,
"target": "\"João Fonseca\""
},
{
"name": "Kennedy Center",
"rank": 5,
"target": "\"Kennedy Center\""
},
{
"name": "#اطلب_من_التشاليح__والورش",
"rank": 6,
"target": "#اطلب_من_التشاليح__والورش"
},
{
"name": "#TaşacakBuDeniz",
"rank": 7,
"target": "#TaşacakBuDeniz"
},
{
"name": "Djokovic",
"rank": 8,
"target": "Djokovic"
},
{
"name": "Abdul Carter",
"rank": 9,
"target": "\"Abdul Carter\""
},
{
"name": "Tommy Paul",
"rank": 10,
"target": "\"Tommy Paul\""
}
],
"meta": {
"result_count": 10
}
}Schema · Response
{
"type": "json",
"example": {
"data": [
{
"name": "#AI",
"rank": 1
}
],
"meta": {
"result_count": 30
}
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"