{"uid":"cap_i4bLIKVPPhT32PG-zkYm8","slug":"glim-sh-twitter-trending-topics-e516138c","name":"glim.sh Twitter Trending Topics","description":"Fetch a tweet (with thread context) by URL/id or a user (with recent tweets) from one URL","url":"https://glim.sh/api/v1/twitter/get","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":["ref"],"properties":{"ref":{"type":"string","maxLength":2048,"minLength":1,"description":"Tweet URL/id or profile URL. Tweet URLs including /i/status/<id> and bare numeric tweet ids return the tweet + thread; a profile URL (https://x.com/<handle>) returns the user + recent tweets."},"cursor":{"type":"string","maxLength":500,"description":"Profile refs only: pagination cursor"},"include":{"type":"array","items":{"enum":["replies","quotes"],"type":"string"},"description":"Tweet refs only: extra sections to include (replies, quotes)"},"expand_urls":{"type":"boolean","default":false,"description":"When true, auto-crawl entity URLs and attach crawled_content to tweets. Off by default: responses can grow by up to 4KB per expanded URL. Use glim_web_crawl(url) for targeted crawls instead."},"include_replies":{"type":"boolean","default":false,"description":"Profile refs only: include replies in the timeline"},"include_mentions":{"type":"boolean","default":false,"description":"Profile refs only: include the mentions timeline"}}},"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"}}}}},"responseSchema":{"type":"json","example":{"tweet":{"id":"123","text":"Hello"},"parent":null,"thread":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.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_hviDXYbSR6eTqnY4NzHZv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches live Twitter/X trending topics for a specified geographic location using a Yahoo Where On Earth ID","exampleAgentPrompt":"What are the top 20 trending topics on Twitter worldwide right now? Use WOEID 1 for global trends.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing trending tweet data including tweet ID, text content, parent tweet context, and thread array. Represents current trending topics for the requested geographic area.","failureModes":["Invalid WOEID returns empty or error response","Count value out of supported range may return validation error","Twitter API rate limits or downtime may result in failed fetch","Payment not processed (x402) results in 402 status with no data returned","Unsupported or obscure WOEID may return no trends"],"whenToPreferThis":"Use this endpoint when you need live Twitter/X trending topic data without managing your own Twitter API credentials or scraping infrastructure. Ideal for agents that need real-time social media pulse data on a pay-per-call basis with no setup overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:49:42.335Z","isFirstParty":false}