{"uid":"cap_i5-RkB1mlQ64OZhBakhCb","slug":"twitter-surf-cascade-fyi-45df7eb1","name":"Twitter Trending Topics by WOEID","description":"Pay-per-use Twitter/X data API with x402 micropayments.","url":"https://twitter.surf.cascade.fyi/trends","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"data":[{"name":"#AI","rank":1}],"meta":{"result_count":30}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"count":10,"woeid":1}}},"response":{"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}}},"exampleRequest":{"count":10,"woeid":1},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_i42AzdO2ZQL3jz8fcO8Le","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 a ranked list of currently trending topics on Twitter/X for a given geographic location identified by WOEID","exampleAgentPrompt":"What are the top 10 trending topics on Twitter right now worldwide? Use WOEID 1 for the global location.","exampleUseCases":[{"title":"Monitor trending topics for content ideas","prompt":"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."},{"title":"Track geographic social media conversations","prompt":"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."},{"title":"Identify viral hashtags for marketing campaigns","prompt":"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."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:54:35.127Z","isFirstParty":false}