{"uid":"cap_emA6uDm4kX1EAsOzOMM2R","slug":"x-tweet-search-via-x402-botsmith-dev-f81d80d4","name":"X Tweet Search via x402 (botsmith.dev)","description":"X Tweet Search ($0.02/call): Search X (Twitter) posts with full advanced-search syntax (from:, since:, until:, exact phrases, boolean operators). Returns up to 20 posts per call as clean JSON with metrics and entities, plus a cursor for the next page. No X account or API key needed.","url":"https://x402.botsmith.dev/x/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["query","type"],"properties":{"type":{"enum":["Latest","Top"],"type":"string","default":"Latest","description":"Sort by recency or engagement"},"query":{"type":"string","maxLength":400,"minLength":1,"description":"Search query, e.g. \"x402 from:coinbase since:2026-07-01\""},"cursor":{"type":"string","pattern":"^[A-Za-z0-9+/=_-]{1,400}$","description":"Pagination cursor from a previous call"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["tweets","hasNextPage","nextCursor"],"properties":{"tweets":{"type":"array","items":{"type":"object","required":["id","url","text","createdAt","lang","author","metrics","hashtags","links","mentions"],"properties":{"id":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"lang":{"anyOf":[{"type":"string"},{"type":"null"}]},"text":{"type":"string"},"links":{"type":"array","items":{"type":"string"},"description":"Expanded outbound URLs"},"author":{"type":"object","required":["handle","name","id"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"metrics":{"type":"object","required":["likes","retweets","replies","quotes","views"],"properties":{"likes":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"views":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"quotes":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"replies":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"retweets":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]}},"additionalProperties":false},"hashtags":{"type":"array","items":{"type":"string"}},"mentions":{"type":"array","items":{"type":"string"},"description":"Mentioned handles"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601"}},"additionalProperties":false},"description":"Up to 20 matching posts"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasNextPage":{"type":"boolean"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.08","successRate":"0.71","reviews":1,"stars":"1.3","state":"rated"},"availabilityStatus":"unknown","priceObserved":{"p10Cents":"2.0000","medianCents":"2.0000","p90Cents":"2.0000","minCents":"2.0000","maxCents":"2.0000","p95Cents":"2.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CH2BxSmtwv1wZ8qrFSnGy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search X (Twitter) posts using full advanced-search syntax and return up to 20 results per call as clean JSON with engagement metrics, entities, and pagination cursor.","exampleAgentPrompt":"Search X for the latest posts mentioning 'x402 from:coinbase' since 2026-07-01, sorted by Latest, and give me up to 20 results with their engagement numbers.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing an array of up to 20 tweets, each with id, url, full text, author (handle, name, id), creation timestamp, language, engagement metrics (likes, retweets, replies, quotes, views), hashtags, mentions, and expanded outbound links. Also includes a hasNextPage boolean and a nextCursor string for fetching the next page of results.","failureModes":["Invalid or unsupported query syntax returns an error response","Cursor value is malformed or expired, preventing pagination","Query exceeds 400-character max length","No tweets found matching the query returns an empty tweets array","Payment of $0.01 USDC not fulfilled via x402 protocol results in 402 response","Rate limiting or X platform unavailability causes timeout or partial results"],"whenToPreferThis":"Use this endpoint when you need to search X/Twitter posts without holding an X developer account or API key, especially when you need advanced-search operators (from:, since:, until:, boolean) and want clean structured JSON output with engagement metrics. Prefer this over scraping or the official X API when cost predictability ($0.01/call), no-auth access, and entity extraction (hashtags, mentions, links) matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":7,"lastUsedAt":"2026-07-24T03:21:26.788Z","lastSuccessfullyRanAt":"2026-07-24T03:21:26.788Z","lastHealthCheckAt":"2026-10-21T03:02:18.716Z","isFirstParty":false,"canonicalSlug":"x-tweet-search-via-x402-botsmith-dev-f81d80d4"}