{"uid":"cap_TRb2Qi-b3t94SdY550JiN","slug":"twitter-x-trending-topics-scraper-98112dc8","name":"Twitter/X Trending Topics Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/twitter-trends?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"day2":{"type":"boolean","default":false,"description":"Try the dated country archive from 2 days ago. Dated country pages may be unavailable."},"day3":{"type":"boolean","default":false,"description":"Try the dated country archive from 3 days ago. Dated country pages may be unavailable."},"live":{"type":"boolean","default":true,"description":"Include the current top 50 trend snapshot."},"hour1":{"type":"boolean","default":true,"description":"Include the trend snapshot from about 1 hour ago."},"hour3":{"type":"boolean","default":false,"description":"Include the trend snapshot from about 3 hours ago."},"hour6":{"type":"boolean","default":false,"description":"Include the trend snapshot from about 6 hours ago."},"hour12":{"type":"boolean","default":false,"description":"Include the trend snapshot from about 12 hours ago."},"hour24":{"type":"boolean","default":false,"description":"Include the oldest available recent snapshot, usually 23 hours ago."},"country":{"enum":["worldwide","algeria","argentina","australia","austria","bahrain","belarus","belgium","brazil","canada","chile","colombia","denmark","dominican-republic","ecuador","egypt","france","germany","ghana","greece","guatemala","india","indonesia","ireland","israel","italy","japan","jordan","kenya","korea","kuwait","latvia","lebanon","malaysia","mexico","netherlands","new-zealand","nigeria","norway","oman","pakistan","panama","peru","philippines","poland","portugal","puerto-rico","qatar","russia","saudi-arabia","singapore","south-africa","spain","sweden","switzerland","thailand","turkey","ukraine","united-arab-emirates","united-kingdom","united-states","venezuela","vietnam"],"type":"string","default":"united-states","description":"Country whose public trending topics to collect. Worldwide collects global trends."},"maxItems":{"type":"integer","default":400,"minimum":0,"description":"Stop after this many trend rows across selected snapshots. 0 removes the limit."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"rank":null,"time":null,"trend":null,"volume":null,"country":null,"trendUrl":null,"observedAt":null,"timePeriod":null}],"product":"twitter-trends"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2Uqm3UFuyGftjKlRbPkVX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches structured snapshots of Twitter/X trending topics for a specified country across multiple time windows (live, hourly, and daily archives).","exampleAgentPrompt":"What are the top trending topics on Twitter/X in the United States right now? Include the live snapshot plus the one from about an hour ago, and cap results at 100 trends.","exampleUseCases":[{"title":"Real-time brand crisis monitoring","prompt":"Pull the current live Twitter trends for the United States plus the snapshot from 1 hour ago — I want to see if any brand names or product keywords are suddenly spiking. Limit to 200 results."},{"title":"Global news pulse check","prompt":"What's trending worldwide on Twitter/X right now? Give me the live top 50 and also the snapshot from 3 hours ago so I can see what changed."},{"title":"Country-specific campaign research","prompt":"Fetch Twitter trending topics for India using the live snapshot, the 1-hour-ago snapshot, and the 6-hour-ago snapshot — I'm researching what's resonating with Indian audiences today. Cap it at 400 results."}],"resultDescription":"Returns a JSON array of trend objects, each containing the trend name, rank, tweet volume, trend URL, country, observed timestamp, and time period label. Multiple snapshots (live, hourly, archived) may be merged into a single result set up to the maxItems cap.","failureModes":["Dated country archive pages (day2/day3) may be unavailable for certain countries, returning empty results — no charge applies","Country not supported or misspelled returns an error or empty dataset","Rate limiting or scraping blocks from Twitter/X may cause failed runs — no charge applies","maxItems=0 with many snapshots selected may return very large payloads"],"whenToPreferThis":"Choose this endpoint when you need structured, ranked Twitter/X trend data for a specific country or globally, across multiple time windows, without managing your own scraping infrastructure. It is pay-per-successful-call, so failed or empty runs are free. Prefer this over general web-scraping endpoints when you specifically need Twitter trend rankings with volume data, timestamps, and country segmentation in a ready-to-use JSON format.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:40:00.714Z","isFirstParty":false,"canonicalSlug":"twitter-x-trending-topics-scraper-98112dc8"}