{"uid":"cap_-tZ64nuAt6obDFTc8DOX4","slug":"twitter-x-trends-by-woeid-08bcf41d","name":"Twitter/X Trends by WOEID","description":"Get ranked Twitter/X trends for a geographic WOEID with normalized search queries, context, post counts and related trends.","url":"https://twitter.use.x402atlas.com/trends","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["woeid"],"properties":{"woeid":{"type":"integer","minimum":1,"description":"Yahoo Where On Earth ID returned by /locations; 1 means Worldwide"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","woeid","trend_count","trends"],"properties":{"woeid":{"type":"integer","minimum":1},"trends":{"type":"array","items":{"type":"object","required":["rank","name","search_query","grouped_trends"],"properties":{"name":{"type":"string"},"rank":{"type":"integer","minimum":1},"context":{"type":"string"},"post_count":{"type":"integer","minimum":0},"search_query":{"type":"string"},"grouped_trends":{"type":"array","items":{"type":"string"}}}}},"queried_at":{"type":"string","format":"date-time"},"trend_count":{"type":"integer","minimum":0}}}}}}},"responseSchema":{"type":"json","example":{"woeid":2442047,"trends":[{"name":"#FogoChain","rank":1,"context":"Trending in Los Angeles","post_count":17100,"search_query":"#FogoChain","grouped_trends":[]},{"name":"Warren Buffett","rank":2,"context":"Business and finance · Trending","post_count":21600,"search_query":"\"Warren Buffett\"","grouped_trends":["Greg Abel","CEO of Berkshire Hathaway"]}],"queried_at":"2026-07-26T12:00:00Z","trend_count":2}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oJDHkJq0j2CSdNdq1EBdA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ranked Twitter/X trends for a given geographic location (WOEID), including normalized search queries, context, post counts, and grouped related trends.","exampleAgentPrompt":"What are the top trending topics on Twitter/X right now worldwide — give me the ranked list with post counts and search queries (use WOEID 1 for worldwide).","exampleUseCases":[{"title":"Monitor worldwide Twitter trends in real time","prompt":"Show me what's trending on Twitter globally right now, with post counts and context for each trend."},{"title":"Track regional trends for a marketing campaign","prompt":"What are the top trending topics on X in the United Kingdom right now? I need the ranked trend names, their search queries, and how many posts each has."},{"title":"Competitive intelligence on social buzz","prompt":"Pull the current Twitter trends for the United States — I want the ranked list, context snippets, and grouped related trends so I can see what topics are dominating the conversation."}],"resultDescription":"Returns a JSON object with the queried WOEID, timestamp of the query, total trend count, and an array of ranked trends. Each trend includes its rank, display name, normalized search query, optional context description, post count, and an array of grouped/related trend names.","failureModes":["Invalid or non-existent WOEID returns an error or empty trend list","WOEID not supported for trends (some locations have no trend data) returns zero trends","Rate limiting or payment failure results in a 402 or 429 error","Trends data may be temporarily unavailable during X/Twitter platform outages"],"whenToPreferThis":"Choose this endpoint when you need ranked, structured trend data for a specific geographic location on Twitter/X, complete with normalized search queries and post counts. It is ideal for social listening, marketing intelligence, content planning, or real-time monitoring of public discourse. Prefer this over a general Twitter search endpoint when you want what is organically trending (not a keyword-driven search) in a specific location.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:36:17.727Z","isFirstParty":false}