{"uid":"cap_yOV1F5W-lTUihY4YFZlA4","slug":"botsmith-x-trends-703e67f3","name":"botsmith X Trends","description":"X Trends ($0.005/call): Top 30 trending topics on X (Twitter) right now for a location by Yahoo WOEID: 1 worldwide, 23424977 United States, 23424975 United Kingdom, 23424856 Japan, 23424748 Australia, 2459115 New York, 44418 London. Each with rank and the search query to pull its posts. The location actually served is echoed back. No X account or API key needed.","url":"https://x402.botsmith.dev/x/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":["woeid"],"properties":{"woeid":{"type":"integer","default":1,"maximum":2147483647,"minimum":1,"description":"Yahoo WOEID of a country or city; 1 = worldwide"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["location","trends","asOf"],"properties":{"asOf":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601 time X computed the trends"},"trends":{"type":"array","items":{"type":"object","required":["rank","name","query"],"properties":{"name":{"type":"string"},"rank":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search query for this trend, usable with /x/search"}},"additionalProperties":false}},"location":{"type":"object","required":["woeid","name"],"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"woeid":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"description":"Location served","additionalProperties":false}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HZyjU4tpN1pISzUQ72Rxb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top 30 trending topics on X (Twitter) for a given location identified by Yahoo WOEID, with rank and search query for each trend.","exampleAgentPrompt":"What are the top 30 trending topics on X right now in the United States? Use WOEID 23424977.","exampleUseCases":[{"title":"Worldwide Twitter trends dashboard","prompt":"Pull the current top 30 worldwide trending topics on X — I need each trend's name, rank, and search query."},{"title":"Country-level trend monitoring","prompt":"What's trending on X right now in Japan? Give me all 30 trends with their ranks and the search queries I can use to find the posts."},{"title":"City-specific trend analysis","prompt":"Show me the top trending topics on X in New York City right now — I want the full ranked list with search queries."}],"resultDescription":"A ranked list of up to 30 trending topics on X for the requested location, each with a rank integer, display name, and search query string usable to pull posts. Also includes the actual location served (WOEID + name) and the ISO 8601 timestamp when X computed the trends.","failureModes":["Invalid or unsupported WOEID returns no trends or an error response","Location has no trend data available (X only supports trends for certain countries and cities)","X backend unavailability causing empty or stale trend data","Payment failure via x402 protocol resulting in 402 response"],"whenToPreferThis":"Choose this endpoint when you need real-time trending topic data from X/Twitter for a specific country or major city without needing an X API key or account. It is ideal for agents that monitor social sentiment, track viral topics, or need to seed further X searches. Prefer it over scraping or official X API when you want a simple pay-per-call model with no OAuth setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:36:02.440Z","isFirstParty":false,"canonicalSlug":"botsmith-x-trends-703e67f3"}