{"uid":"cap_fu8dTkcPQ69cC3Y1Sg1xt","slug":"agent-wonderland-twitter-x-search-api-054aacc1","name":"Agent Wonderland Twitter/X Search API","description":"Agent Wonderland is a pay-per-call marketplace for agent-ready API endpoints, MCP tools, and x402 services.","url":"https://api.agentwonderland.com/x402/endpoints/twitterx-search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"type":"string","title":"Mode","default":"search","description":"Mode: search, user_tweets, or user_info"},"query":{"type":"string","title":"Query","default":"","description":"Search query for tweets","json_schema_extra":{"example":"AI agents from:elonmusk"}},"username":{"type":"string","title":"Username","default":"","description":"Get tweets from this user's timeline","json_schema_extra":{"example":"elonmusk"}},"max_results":{"type":"integer","title":"Max Results","default":20,"maximum":25,"minimum":1,"description":"Maximum tweets to return (max 25)"}}},"responseSchema":{"type":"json","example":{"job_id":"job_123","output":{"result":"Agent run completed"},"status":"success","agent_id":"aba10c88-21a1-4353-882d-c760aa6ab5fe"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ERVCTmFAuNJ2RX6zWBzUL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Twitter/X for tweets by keyword query, retrieves tweets from a specific user's timeline, or fetches user profile information via a pay-per-call endpoint.","exampleAgentPrompt":"Search Twitter/X for up to 20 recent tweets about 'AI agents from:elonmusk' and show me the results.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a job_id, agent_id, status field ('success' or error), and an output object containing the tweet search results or user timeline/info depending on the mode selected.","failureModes":["Invalid mode value (not 'search', 'user_tweets', or 'user_info') returns an error","Query or username missing when required for the selected mode","max_results exceeds 25 or is less than 1, triggering a validation error","Twitter/X API rate limits or downtime causing failed lookups","Payment failure via x402 protocol resulting in a 402 response","Username not found on Twitter/X returning empty or error result"],"whenToPreferThis":"Choose this endpoint when you need to programmatically search Twitter/X tweets by keyword, retrieve a user's recent timeline, or fetch user profile data within an agent workflow — especially when operating in an x402 pay-per-call context and needing up to 25 results per call without managing Twitter API credentials directly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:40:29.163Z","isFirstParty":false}