{"uid":"cap_JcvsCusK-v6xSO1j9Zbsw","slug":"payweave-twitter-trends-f4651d4f","name":"PayWeave Twitter Trends","description":"X/Twitter data — tweets, users, communities, lists, articles, and trends.","url":"https://twitter.payweave.services/trends","method":"GET","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":{"anyOf":[{"not":{}},{"type":"object","required":["woeid"],"properties":{"count":{"type":"string","pattern":"^\\d+$","description":"Number of trends to return. Minimum/default 30, max 100. Price scales with this value (15 credits/trend)."},"woeid":{"type":"string","pattern":"^\\d+$","description":"Yahoo \"Where On Earth ID\" for the location, e.g. 1 (worldwide), 2418046."}},"additionalProperties":false}]},"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"bodyType":{"type":"string","const":"json"}},"additionalProperties":false},"output":{"type":"object","required":["example"],"properties":{"example":{"type":"object","properties":{"status":{"type":"string"},"trends":{"type":"array","items":{"type":"object","additionalProperties":{}},"description":"Array of trend objects: name, target query, rank."}},"description":"Trends JSON forwarded verbatim from twitterapi.io.","additionalProperties":true}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007965","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.007965/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007965","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007965","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dJGI2A-rySBOq4OtgqBU-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007965","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches trending topics on X/Twitter for a specified geographic location using a Yahoo WOEID","exampleAgentPrompt":"What are the top 50 trending topics on Twitter right now globally — use WOEID 1 for worldwide and return 50 trends.","exampleUseCases":[{"title":"Real-time global trend monitoring","prompt":"Pull the top 100 trending topics worldwide on Twitter right now using WOEID 1 — I want to see what the whole world is talking about."},{"title":"Country-specific trend tracking","prompt":"What are the top 30 trending topics on X in the United States right now? Use the US WOEID."},{"title":"Marketing campaign pulse check","prompt":"Fetch the current top 50 Twitter trends for New York City (WOEID 2459115) so I can see if any are relevant to our product launch today."}],"resultDescription":"A JSON object containing a status field and a trends array, where each trend object includes the trend name, target query string, and rank. The response is forwarded verbatim from twitterapi.io. Up to 100 trends can be returned per call depending on the count parameter.","failureModes":["Invalid WOEID returns empty trends array or error status","Count value outside 30–100 range may be rejected or clamped","Rate limiting or upstream twitterapi.io outage returns non-200 status","Missing required woeid field causes schema validation failure","Payment failure (x402) prevents request from being processed"],"whenToPreferThis":"Choose this endpoint when you need location-specific or worldwide trending topics from X/Twitter indexed by Yahoo WOEID. It is ideal for social listening, marketing intelligence, content strategy, and real-time event monitoring. It is more cost-effective than building a direct Twitter API integration and supports pay-per-call billing in USDC via x402 with no subscription required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:36:30.735Z","isFirstParty":false}