{"uid":"cap_PZ4iHJlaTP5ubrnFrfI3_","slug":"twitter-trends-scraper-x402-32ce94e1","name":"Twitter Trends Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/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_AJAMAMGHGkTiRxUBNm095","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":"Returns structured snapshots of Twitter/X trending topics for a specified country across multiple time windows, billed per successful call via x402 micropayments.","exampleAgentPrompt":"Pull the current live Twitter trends plus the snapshot from 1 hour ago for the United States, and give me up to 200 trend rows.","exampleUseCases":[{"title":"Real-time social listening dashboard","prompt":"Grab the live Twitter trends right now for worldwide and also from 3 hours ago — I want to see what topics are rising globally. Limit it to 300 rows."},{"title":"Country-specific trend history report","prompt":"Fetch Twitter trending topics for India across the last 24 hours — include the live snapshot, the 6-hour snapshot, and the 12-hour snapshot so I can see how trends shifted throughout the day."},{"title":"Breaking news social signal detection","prompt":"What's trending on Twitter in the United Kingdom right now and 1 hour ago? I want to catch anything that might signal breaking news — give me up to 100 trends."}],"resultDescription":"A JSON object with a count and an array of trend items, each containing: trend name, rank, tweet volume, trend URL, country, the time period label, and the observedAt timestamp. Multiple time-window snapshots are merged into a single list up to the maxItems cap.","failureModes":["Dated country archive pages (day2, day3) may be unavailable for certain countries, returning empty or partial results — not charged","Empty result set if trends cannot be scraped for the requested country/time window","Network or upstream Twitter page structure changes could cause parsing failures — not charged if empty","Invalid country enum value returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need structured, multi-snapshot Twitter trend data for a specific country or globally, especially if you want to compare trends across time windows within a single call. It is pay-per-success, so failed or empty runs are free. Prefer this over manual scraping or general-purpose web scrapers when you need clean, row-level trend data (rank, volume, URL, timestamp) without building your own parser.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:40.772Z","isFirstParty":false,"canonicalSlug":"twitter-trends-scraper-x402-32ce94e1"}