{"uid":"cap_1CmrPDg0e0MoOc_nuxlha","slug":"glim-sh-twitter-trends-a42db14b","name":"glim.sh Twitter Trends","description":"Trending topics","url":"https://surf.cascade.fyi/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":{"ref":"https://x.com/home"},"response":{"data":[{"name":"#GMMTVOuting2026","rank":1,"target":"#GMMTVOuting2026"},{"name":"Shrek","rank":2,"target":"Shrek"},{"name":"#WUTheSeriesEP7","rank":3,"target":"#WUTheSeriesEP7"},{"name":"#لامركم_متبع","rank":4,"target":"#لامركم_متبع"},{"name":"#喧嘩独学は原作もアツい","rank":5,"target":"#喧嘩独学は原作もアツい"},{"name":"対象連載マンガ3作品","rank":6,"target":"対象連載マンガ3作品"},{"name":"マンガコイン","rank":7,"target":"マンガコイン"},{"name":"ドラマ配信記念👊#LINE","rank":8,"target":"ドラマ配信記念👊#LINE"},{"name":"Senegal","rank":9,"target":"Senegal"},{"name":"Woll","rank":10,"target":"Woll"},{"name":"#サカナ山口ANN","rank":11,"target":"#サカナ山口ANN"},{"name":"NAMTANFILM DAY OUT","rank":12,"target":"\"NAMTANFILM DAY OUT\""},{"name":"Cursor","rank":13,"target":"Cursor"},{"name":"SHEEP TFO TOY STORY 5","rank":14,"target":"\"SHEEP TFO TOY STORY 5\""},{"name":"Norway","rank":15,"target":"Norway"},{"name":"Grammy","rank":16,"target":"Grammy"},{"name":"Chalobah","rank":17,"target":"Chalobah"},{"name":"Andrae","rank":18,"target":"Andrae"},{"name":"Ersson","rank":19,"target":"Ersson"},{"name":"PERTHSANTA ESCAPE OUTING","rank":20,"target":"\"PERTHSANTA ESCAPE OUTING\""},{"name":"Stolarz","rank":21,"target":"Stolarz"},{"name":"Tuchel","rank":22,"target":"Tuchel"},{"name":"The View","rank":23,"target":"\"The View\""},{"name":"Benoit","rank":24,"target":"Benoit"},{"name":"Hockey Night in Canada","rank":25,"target":"\"Hockey Night in Canada\""},{"name":"Iraq","rank":26,"target":"Iraq"},{"name":"Alfonso Obregón","rank":27,"target":"\"Alfonso Obregón\""},{"name":"JUNIORMARK OUTING2026","rank":28,"target":"\"JUNIORMARK OUTING2026\""},{"name":"Berlinie","rank":29,"target":"Berlinie"},{"name":"Shallet","rank":30,"target":"Shallet"}],"meta":{"result_count":30}}},"exampleRequest":{"ref":"https://x.com/home"},"tags":["x402"],"displayCostAmount":"0.001","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.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_wgtMRhxZoUEoqPDZXQ3PG","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 Twitter/X trending topics with rank and name data, without requiring API keys","exampleAgentPrompt":"What's trending on Twitter/X right now? Give me the top trends with their rankings.","exampleUseCases":[{"title":"Real-time social media monitoring dashboard","prompt":"Pull the current trending topics from Twitter and show me what's gaining momentum right now. I need the top 5 with their rankings so I can understand what people are talking about."},{"title":"Content ideation from trending conversations","prompt":"What hashtags and topics are trending on X today? I'm looking for content inspiration, so give me the ranked list of what's hot so I can see what my audience is interested in."},{"title":"Breaking news detection via social signals","prompt":"Monitor Twitter trends and alert me if any major topics suddenly spike in the rankings. I want to catch emerging stories as they trend so I can stay ahead of the news cycle."}],"resultDescription":"A JSON object containing an array of trending topics, each with a name and rank, plus metadata including result count. Example: {data: [{name: 'x402', rank: 1}], meta: {result_count: 1}}","failureModes":["Payment not received — returns 402 Payment Required if USDC payment is not attached","Twitter API downtime — upstream data unavailable, returns 503 or error","Rate limiting — too many requests in a short window may be rejected","Empty trends — if no trends are available for the requested region, result_count may be 0","Invalid request body — malformed POST payload may return 400 Bad Request"],"whenToPreferThis":"Choose this endpoint when you need live, real-time Twitter/X trending data without managing your own Twitter API credentials or scraping infrastructure. Ideal for agents that need to monitor social media trends on-demand, paying only per call via x402/USDC micropayments rather than maintaining a monthly API subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:41:47.980Z","isFirstParty":false}