{"uid":"cap_VlSjAnkgu_sjHB1wl7wg6","slug":"twitter-x-trending-topics-by-woeid-9c55cdec","name":"Twitter/X Trending Topics by WOEID","description":"Trending topics","url":"https://twitter.surf.cascade.fyi/api/v1/twitter/trends","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{"count":{"type":"integer","default":30,"maximum":9007199254740991,"minimum":1,"description":"Maximum trends to return"},"woeid":{"type":"integer","default":1,"maximum":9007199254740991,"minimum":-9007199254740991,"description":"Yahoo Where On Earth ID. Defaults to 1 for worldwide trends."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"rank":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"target":{"type":"string"}}}},"meta":{"type":"object","required":["result_count"],"properties":{"result_count":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_K93U36BdNFWtS4MHpuMDe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top trending topics on Twitter/X for a given location, identified by Yahoo Where On Earth ID (WOEID).","exampleAgentPrompt":"What are the top 20 trending topics on Twitter worldwide right now? Give me the ranked list with their names.","exampleUseCases":[{"title":"Monitor global Twitter trends daily","prompt":"Pull the top 30 trending topics on Twitter globally for today and tell me what's dominating conversation right now."},{"title":"Track local trends for a city","prompt":"What's trending on Twitter in the United States right now? Show me the top 20 trends — use WOEID 23424977 for the US."},{"title":"Build a trend briefing for a brand","prompt":"Get me the top 15 trending Twitter topics worldwide so I can check if any are relevant to our product launch today."}],"resultDescription":"An array of trending topic objects each containing the trend name, its rank, and a target URL, along with metadata showing the total result count. Results are ordered by rank and scoped to the requested WOEID location.","failureModes":["Invalid or unsupported WOEID returns empty trends array or error","Count parameter out of range may be rejected or clamped","Twitter API rate limits on the backend may cause temporary failures","Location has no available trend data (some small WOEIDs are unsupported)","Payment failure due to insufficient USDC balance returns 402"],"whenToPreferThis":"Use this endpoint when you need real-time ranked Twitter/X trending topics for a specific location or globally. Prefer this over manual scraping or general news APIs when you specifically need Twitter trend signals with rank ordering and WOEID-based geographic filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:40:41.225Z","isFirstParty":false}