{"uid":"cap_Ksyi6HFmHfYLNM_onb9wt","slug":"mapleai-x-twitter-search-ada7f543","name":"MapleAI X/Twitter Search","description":"14 chat models (GPT + Claude), 7 image models, and Jev structured decisions. Pay per request in USDC on Base with x402.","url":"https://base.mapleai.shop/v1/x/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","description":"What to look for on X/Twitter, 1-2000 characters"},"format":{"enum":["text","json"],"type":"string","default":"text","description":"json returns a validated posts array {url, author, date, text, likes, reposts} instead of a prose summary"},"hours_back":{"type":"integer","maximum":168,"minimum":1,"description":"Restrict search to the last N hours (date filter on the X side)"},"include_web":{"type":"boolean","default":false,"description":"Also run a web search alongside X"},"max_results":{"type":"integer","default":10,"maximum":25,"minimum":1,"description":"Maximum posts cited"},"instructions":{"type":"string","description":"Optional extra instructions for the search agent"}}},"responseSchema":{"type":"json","example":{"usage":{"input_tokens":1200,"output_tokens":300},"object":"response","citations":["https://x.com/user/status/123"],"output_text":"..."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.031","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.031/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.031","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.031","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vcf4OseYEN_Woyzrs2pi9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.031","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches X/Twitter posts by query with optional web search, returning AI-summarized results or structured post arrays, paid per-request in USDC via x402.","exampleAgentPrompt":"Search X for posts about the Bitcoin ETF approval from the last 48 hours, return up to 15 results as a structured JSON array with URLs and engagement counts, and also run a web search alongside it.","exampleUseCases":[{"title":"Brand mention monitoring on X","prompt":"Search X for any posts mentioning 'Acme Corp' or 'AcmeCorp' from the last 24 hours, return up to 20 results as a JSON array so I can see who's talking about us and what they're saying."},{"title":"Breaking news social pulse check","prompt":"What are people saying on X about the earthquake in Tokyo right now? Search the last 6 hours, give me a prose summary, and cite the top 10 posts."},{"title":"Competitor product launch tracking","prompt":"Search X for posts about the new Rivian R3 launch from the past 72 hours — up to 25 results in JSON format — and also include web results alongside the tweets so I get a full picture."}],"resultDescription":"Returns either a prose AI-generated summary of relevant X posts with citation URLs, or a validated JSON array of up to 25 posts each containing URL, author, date, text, likes, and reposts — plus input/output token usage stats.","failureModes":["Query string exceeds 2000 characters — validation error","hours_back exceeds 168 (7 days) — clamped or rejected","Payment not accepted / USDC balance insufficient via x402 — 402 Payment Required","X-side rate limiting or no results found for narrow queries — empty citations array","Invalid format enum value — schema validation error"],"whenToPreferThis":"Choose this endpoint when you need real-time or recent X/Twitter post data with AI summarization and optional web augmentation, especially when structured citation output (JSON with engagement metrics) is needed. Prefer over general web search when X-specific social signals, tweet engagement data, or author attribution matter. Best for brand monitoring, news pulse checks, and trend tracking within a rolling 7-day window.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:43:04.032Z","isFirstParty":false,"canonicalSlug":"mapleai-x-twitter-search-ada7f543"}