{"uid":"cap_r8bcXSciFZWT1xlKIk3jT","slug":"glim-sh-twitter-trending-tweets-d1dc43a2","name":"glim.sh Twitter Trending Tweets","description":"Batch fetch tweets by IDs","url":"https://glim.sh/api/v1/twitter/tweets","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","required":["ids"],"properties":{"ids":{"type":"string","description":"Comma-separated tweet IDs"}}},"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","propertyNames":{"type":"string"},"additionalProperties":{}}},"meta":{"type":"object","required":["result_count"],"properties":{"next_cursor":{"type":"string"},"result_count":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"has_next_page":{"type":"boolean"}}},"summary":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"id":"1234567890","text":"Example tweet"}],"meta":{"result_count":1}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_O26LMgT3ha5hjJueEQg1I","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches live trending tweets from Twitter/X for a specified geographic location using a Yahoo WOEID","exampleAgentPrompt":"What are the top 20 trending tweets worldwide on Twitter right now? Use WOEID 1 for global trends.","exampleUseCases":null,"resultDescription":"A JSON object with a 'data' array of tweet objects (each containing tweet ID and text) and a 'meta' object with result_count. Returns up to the requested number of trending tweets for the specified WOEID location.","failureModes":["Invalid or unsupported WOEID returns empty or error response","Count exceeding available trends returns fewer results than requested","Payment failure (402) if USDC balance is insufficient","Rate limiting or upstream Twitter API unavailability causes 5xx errors","Malformed request body returns 400 validation error"],"whenToPreferThis":"Use this endpoint when you need live, real-time Twitter trending data without managing your own Twitter API keys or scraping infrastructure. Ideal for agents that need geographic-specific Twitter trends via WOEID, pay-per-call pricing with no subscription commitment, and zero setup overhead. Prefer over direct Twitter API integration when you want instant access with crypto micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:45:18.393Z","isFirstParty":false}