{"uid":"cap_feh4tHHyJyCOIZZI98GXg","slug":"readx-trending-topics-a85ff626","name":"ReadX Trending Topics","description":"Trending topics for a location (worldwide by default; filter with country or woeid). Example: GET /api/trends?country=US","url":"https://readx.sh/api/trends","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"code":0,"data":{"as_of":"2026-07-25T04:51:10Z","woeid":23424977,"status":"success","trends":[{"name":"#TypeScript","rank":1,"query":"#TypeScript","promoted":false,"is_hashtag":true,"search_url":"https://x.com/search?q=%23TypeScript&src=trend_click","tweet_volume":18452},{"name":"Cloudflare","rank":2,"query":"Cloudflare","promoted":false,"is_hashtag":false,"search_url":"https://x.com/search?q=Cloudflare&src=trend_click","tweet_volume":null}],"location":"United States","trends_count":2}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XiSQI5PctEoA7y8OGj1bk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","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 X/Twitter for a given location (WOEID), including rank, tweet volume, and search URLs","exampleAgentPrompt":"What topics are trending right now on X in the United States? Give me the current trend list with ranks and tweet volumes.","exampleUseCases":[{"title":"Real-time social trend dashboard","prompt":"Pull the current trending topics on X for the United States and show me the top 10 with their tweet volumes and whether they're hashtags or plain topics."},{"title":"Content strategy based on trends","prompt":"What's trending on X right now in the US? I want to write a blog post that taps into today's top conversations — show me the ranked trend list."},{"title":"Brand monitoring for viral moments","prompt":"Check what's trending on X/Twitter in the US right now and flag anything in the top 20 that might be relevant to a tech company — I need the trend names, ranks, and search URLs."}],"resultDescription":"A JSON object containing a list of trending topics for the requested location, each with: name, rank, query string, promoted flag, hashtag flag, search URL on X, and tweet volume (may be null). Also includes the location name (e.g. 'United States'), WOEID, timestamp of when trends were measured (as_of), and a status field.","failureModes":["Invalid or unsupported WOEID returns an error or empty trends array","Trends data may be stale if X API upstream is delayed — check the as_of timestamp","tweet_volume can be null for lower-volume trends where X withholds counts","Payment failure (insufficient USDC balance) results in 402 response before data is returned","Rate limiting or upstream X API unavailability may cause transient failures"],"whenToPreferThis":"Choose this endpoint when you need real-time trending topic data from X/Twitter without managing Twitter API credentials or developer accounts. It is ideal for agents that need to react to live social conversations, surface viral topics for content planning, or monitor what's being discussed publicly — all paid per-call via x402 micropayments with no API key setup required. Prefer this over scraping or unofficial tools when you need structured, ranked trend data with tweet volumes and search URLs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:47:34.684Z","isFirstParty":false}