{"uid":"cap_qYMNzwp3Z85gcZd2OLe_D","slug":"scriptmasterlabs-public-x-twitter-search-f7bb82bc","name":"SCRIPTMASTERLABS Public X (Twitter) Search","description":"Pay-per-call APIs and a read-only provider check for x402 buyers. Inspect evidence and live terms before a caller-controlled payment; accept delivery with proof.","url":"https://scriptmasterlabs.com/api/x/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":512,"minLength":1,"description":"Public X search query Search intents: x search, twitter search, social search, public posts, social research."},"type":{"enum":["Latest","Top"],"type":"string","description":"Search intents: x search, twitter search, social search, public posts, social research."},"max_results":{"enum":["1","2","3","4","5","6","7","8","9","10"],"type":"string","description":"Search intents: x search, twitter search, social search, public posts, social research."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object"}},"additionalProperties":false}},"additionalProperties":false},"responseSchema":{"type":"json","example":{"type":"Latest","query":"x402","status":"ready","product":"SML Public X Search","results":[{"id":"<public-post-id>","url":"https://x.com/<public-handle>/status/<public-post-id>","text":"<public-post-text>","author":{"username":"<public-handle>"},"created_at":"<source-timestamp>"}],"provenance":{"provider":"twitterapis","public_read_only":true},"result_count":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0048","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.0048/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0048","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0048","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HXDMse-w-jPzy2E-qxRZL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0048","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search public X (Twitter) posts by keyword query and return latest or top results with author and metadata, paid per call via x402.","exampleAgentPrompt":"Search X for the latest 5 posts mentioning 'x402' and show me the text and author of each one.","exampleUseCases":[{"title":"Brand mention monitoring on X","prompt":"Find the 10 most recent posts on X mentioning 'OpenAI' so I can see what people are saying about them right now."},{"title":"Trend research for a topic","prompt":"Search X for the top 5 posts about 'bitcoin ETF' — I want to see what's getting the most engagement on that topic today."},{"title":"Competitor sentiment snapshot","prompt":"Pull the latest 7 public X posts that mention 'Stripe payments' so I can get a quick read on current social sentiment."}],"resultDescription":"Returns a JSON object containing the search query, result type, product name, and an array of up to 10 posts each with post ID, public URL, post text, author username, and creation timestamp, plus provenance info confirming the underlying provider is Twitter APIs in read-only mode.","failureModes":["Empty results if query matches no recent public posts","Payment failure if x402 wallet balance is insufficient or payment is rejected","Rate limiting or quota errors from the underlying Twitter API","Invalid query parameter (empty string or exceeding 512 characters) returns validation error","Unsupported type enum value causes schema validation failure"],"whenToPreferThis":"Choose this endpoint when you need real-time public X/Twitter post retrieval in a pay-per-call model without a long-term API subscription. Ideal for agents that need occasional social search without managing Twitter API credentials directly. Particularly suited for x402-compatible agent workflows where micropayment per call is acceptable and you want read-only access to public posts with provenance guarantees.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T03:03:07.088Z","isFirstParty":false,"canonicalSlug":"scriptmasterlabs-public-x-twitter-search-f7bb82bc"}