{"uid":"cap_h_i9H136QERbnu6jphnK6","slug":"twitter-x-trending-topics-by-location-2e4ecd72","name":"Twitter/X Trending Topics by Location","description":"Get the current trending topics for a specific location on Twitter/X.","url":"https://x402.apidirect.io/v1/twitter/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["woeid"],"properties":{"woeid":{"type":"integer","minimum":1,"description":"Where On Earth ID for the location. Use 1 for Worldwide."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","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.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MAe8FrRVtYFukdEx00GVV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current trending topics on Twitter/X for a specific location identified by its WOEID (Where On Earth ID).","exampleAgentPrompt":"What are the trending topics on Twitter right now worldwide? Use WOEID 1 to get the global trends.","exampleUseCases":[{"title":"Monitor global Twitter trends in real-time","prompt":"What's trending on Twitter worldwide right now? Pull the top global trending topics using WOEID 1."},{"title":"Track local trends for a city","prompt":"What are people talking about on Twitter in the UK right now? Get me the current trending topics for the UK — its WOEID is 23424975."},{"title":"Competitive social listening for a brand","prompt":"Can you check what's currently trending on Twitter in the United States? Use WOEID 23424977 so I can see if any topics are relevant to our brand campaign."}],"resultDescription":"A list of current trending topics on Twitter/X for the specified location, typically including trend names, associated hashtags, tweet volume counts, and related metadata such as trend URLs.","failureModes":["Invalid or unsupported WOEID returns an error or empty result","WOEID is a required integer — omitting it causes a validation error","Twitter/X API rate limits or outages may result in failed responses","Some locations may have no trends data available if Twitter doesn't track that WOEID","Trends data may be stale if Twitter's underlying API caches results"],"whenToPreferThis":"Choose this endpoint when you need real-time Twitter/X trending topics for a specific geographic location identified by WOEID. It is ideal for social listening, content strategy, news monitoring, or competitive analysis tied to Twitter trend data. Prefer this over generic search endpoints when you specifically need location-based Twitter trends rather than keyword search results or posts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:03.140Z","isFirstParty":false,"canonicalSlug":"twitter-x-trending-topics-by-location-2e4ecd72"}