{"uid":"cap_-tZ64nuAt6obDFTc8DOX4","slug":"twitter-x-trends-by-woeid-08bcf41d","name":"Twitter/X Trends by WOEID","description":"Twitter/X trends right now — the ranked list of trending topics and hashtags on Twitter/X for any country by ISO code (US, GB, JP, worldwide) or a city by WOEID, each with post count, search query and related trends. For trend tracking, social listening and viral-topic discovery.","url":"https://twitter.use.x402atlas.com/trends?utm_source=zero.xyz","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":["country"],"properties":{"woeid":{"type":"integer","minimum":1,"description":"City scope from /locations; overrides country"},"country":{"enum":["worldwide","AE","AR","AT","AU","BE","BH","BR","BY","CA","CH","CL","CO","DE","DK","DO","DZ","EC","EG","ES","FR","GB","GH","GR","GT","ID","IE","IL","IN","IT","JO","JP","KE","KR","KW","LB","LV","MX","MY","NG","NL","NO","NZ","OM","PA","PE","PH","PK","PL","PR","PT","QA","RU","SA","SE","SG","TH","TR","UA","US","VE","VN","ZA"],"type":"string","description":"ISO 3166-1 alpha-2 country code or worldwide; defaults to US when omitted"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","query","woeid","trend_count","trends"],"properties":{"query":{"type":"string","description":"Effective scope: country=US or woeid=2442047"},"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.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oJDHkJq0j2CSdNdq1EBdA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","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-10-28T12:34:51.830Z","isFirstParty":false,"canonicalSlug":"twitter-x-trends-by-woeid-08bcf41d"}