{"uid":"cap_-Ks7M7zU8vVsnXob2eZLy","slug":"glim-sh-twitter-trends-2a92d884","name":"glim.sh Twitter Trends","description":"Trending topics","url":"https://glim.sh/api/v1/twitter/trends","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{"count":{"type":"integer","default":30,"maximum":9007199254740991,"minimum":1,"description":"Maximum trends to return"},"woeid":{"type":"integer","default":1,"maximum":9007199254740991,"minimum":-9007199254740991,"description":"Yahoo Where On Earth ID. Defaults to 1 for worldwide trends."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"rank":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"target":{"type":"string"}}}},"meta":{"type":"object","required":["result_count"],"properties":{"result_count":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}}}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"name":"x402","rank":1}],"meta":{"result_count":1}}},"example":{"request":{"count":10,"woeid":1},"response":{"data":[{"name":"South Korea","rank":1,"target":"\"South Korea\""},{"name":"中村玉緒さん","rank":2,"target":"中村玉緒さん"},{"name":"olivia","rank":3,"target":"olivia"},{"name":"كوريا","rank":4,"target":"كوريا"},{"name":"República Checa","rank":5,"target":"\"República Checa\""},{"name":"ゲリラ豪雨","rank":6,"target":"ゲリラ豪雨"},{"name":"COME OVER OUT NOW","rank":7,"target":"\"COME OVER OUT NOW\""},{"name":"#忍者とは忍び弾く者","rank":8,"target":"#忍者とは忍び弾く者"},{"name":"肺炎のため","rank":9,"target":"肺炎のため"},{"name":"#2026BTSFESTA","rank":10,"target":"#2026BTSFESTA"}],"meta":{"result_count":10}}},"exampleRequest":{"count":10,"woeid":1},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QQ-C4EZG0V5oaIiyLmeUq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches live trending topics on Twitter/X, returning ranked trend names and counts","exampleAgentPrompt":"What are the top trending topics on Twitter right now? Give me a ranked list of what's currently going viral on X.","exampleUseCases":null,"resultDescription":"A JSON object containing an array of trending topic objects each with a name and rank, plus metadata including the result count — e.g. [{name: 'x402', rank: 1}, ...] with a meta.result_count field.","failureModes":["Payment not included or insufficient — 402 Payment Required","Twitter API rate limit exceeded — upstream rate limit error","Invalid request body parameters — 400 Bad Request","Twitter/X platform outage causes empty or stale results","No trends available for the specified filter — empty data array"],"whenToPreferThis":"Use this endpoint when you need live, real-time Twitter/X trending data without managing your own Twitter API keys or scraping infrastructure. Ideal for agents that need to monitor viral topics, surface trending conversations, or provide social listening insights on demand, paying only per call at $0.001 USDC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-07-02T03:23:11.245Z","lastSuccessfullyRanAt":"2026-07-02T03:23:11.245Z","lastHealthCheckAt":"2026-09-13T12:34:56.798Z","isFirstParty":false}