{"uid":"cap_ywnoVNmTddTO9lTd2a7ui","slug":"payweave-twitter-tweet-search-39c79858","name":"PayWeave Twitter Tweet Search","description":"X/Twitter data — tweets, users, communities, lists, articles, and trends.","url":"https://twitter.payweave.services/tweets/search","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":["query"],"properties":{"type":{"enum":["Latest","Top"],"type":"string","description":"Result ranking: \"Latest\" (default) or \"Top\"."},"query":{"type":"string","minLength":1,"description":"Search terms using X advanced-search syntax, e.g. \"from:elonmusk since:2024-01-01\"."},"next_token":{"type":"string","description":"Pagination cursor from a previous response `next_cursor`. Omit for the first page."}},"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":{"tweets":{"type":"array","items":{"type":"object","additionalProperties":{}},"description":"Array of tweet objects."},"next_cursor":{"type":"string","description":"Cursor to pass as `next_token` for the next page."},"has_next_page":{"type":"boolean","description":"True when more pages are available."}},"description":"Tweet list JSON forwarded verbatim from twitterapi.io.","additionalProperties":true}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mHmD9AUveI4Odo7lKlRTA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search X/Twitter tweets using advanced search syntax, returning paginated tweet objects via a pay-per-call API","exampleAgentPrompt":"Search Twitter for the latest tweets about 'AI agents' using X advanced search syntax — show me the most recent results and include a cursor so I can get the next page.","exampleUseCases":[{"title":"Brand mention monitoring for PR","prompt":"Find the latest tweets mentioning 'OpenAI' since January 1 2025 — I want to see what people are saying most recently, not just the top posts."},{"title":"Competitor analysis from Twitter","prompt":"Search Twitter for top tweets from @elonmusk in the last 30 days — use the query 'from:elonmusk since:2025-01-01' and give me the top-ranked results."},{"title":"Breaking news discovery on a topic","prompt":"Find the most recent tweets about 'Fed interest rate decision' on X — I want the latest results so I can track breaking news as it happens."}],"resultDescription":"A JSON object containing an array of tweet objects (each with full tweet metadata as forwarded from twitterapi.io), a next_cursor string for fetching the next page, and a has_next_page boolean indicating whether more results are available.","failureModes":["Empty results if query matches no tweets or is too narrow","Invalid query syntax returns an error from the upstream Twitter API","Missing required 'query' field causes a validation error","Expired or invalid next_token causes pagination failure","Rate limiting or upstream twitterapi.io downtime causing 5xx errors","Payment failure (x402) if wallet has insufficient USDC balance"],"whenToPreferThis":"Choose this endpoint when you need to search public X/Twitter tweets by keyword, hashtag, user, or advanced search syntax and want pay-per-call pricing with no subscription commitment. Prefer it over scraping or official Twitter API when you need simple programmatic access with USDC micropayments and no OAuth setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:40:38.277Z","isFirstParty":false}