{"uid":"cap_s7oaG02SwxM8GzVwZ5kFq","slug":"www-surplusintelligence-ai-6a225f89","name":"Surplus Intelligence X/Twitter Recent Tweet Search","description":"X/Twitter API v2 via Surplus Intelligence: Tweet search (10 units)","url":"https://www.surplusintelligence.ai/x402/api/twitter/v2/tweets/search/recent","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"X/Twitter recent search query."},"max_results":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of results to return."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{},"meta":{"type":"object"},"errors":{"type":"array"}},"additionalProperties":true}}}}},"responseSchema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","text","edit_history_tweet_ids"],"properties":{"id":{"type":"string"},"text":{"type":"string"},"edit_history_tweet_ids":{"type":"array","items":{"type":"string"}}}}},"meta":{"type":"object","required":["newest_id","oldest_id","next_token","result_count"],"properties":{"newest_id":{"type":"string"},"oldest_id":{"type":"string"},"next_token":{"type":"string"},"result_count":{"type":"number"}}}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"query":"artificial intelligence","max_results":10}}},"response":{"data":[{"id":"2062710080311644645","text":"Compute Reality of Artificial Intelligence in Global Health LMICs - ICTworks https://t.co/yppG5qAu5F","edit_history_tweet_ids":["2062710080311644645"]},{"id":"2062710075635138668","text":"RT @heyalexmoore: All Paid Courses (Free for First 4500 People)\n\n 𝗣𝗮𝗶𝗱 𝗖𝗼𝘂𝗿𝘀𝗲 𝗙𝗥𝗘𝗘 (PART - 1)\n 1. Artificial Intelligence\n 2. Machine Learn…","edit_history_tweet_ids":["2062710075635138668"]},{"id":"2062710074234282123","text":"RT @heyalexmoore: All Paid Courses (Free for First 4500 People)\n\n 𝗣𝗮𝗶𝗱 𝗖𝗼𝘂𝗿𝘀𝗲 𝗙𝗥𝗘𝗘 (PART - 1)\n 1. Artificial Intelligence\n 2. Machine Learn…","edit_history_tweet_ids":["2062710074234282123"]},{"id":"2062710071449264264","text":"RT @heyalexmoore: All Paid Courses (Free for First 4500 People)\n\n 𝗣𝗮𝗶𝗱 𝗖𝗼𝘂𝗿𝘀𝗲 𝗙𝗥𝗘𝗘 (PART - 1)\n 1. Artificial Intelligence\n 2. Machine Learn…","edit_history_tweet_ids":["2062710071449264264"]},{"id":"2062710048539787691","text":"RT @NCRonline: \"Artificial intelligence exposes the limits of isolated expertise,\" Enzo Del Brocco writes. https://t.co/H5g52TpCUu","edit_history_tweet_ids":["2062710048539787691"]},{"id":"2062710045121400853","text":"A.I ( Artificial Intelligence ) Selection Results for Turffontein, 4 June 2026. Top4 Pick6 Win R12,405.80😎 Check and Confirm results here https://t.co/MTm2cfAPzv Help A.I & Earn https://t.co/PJgDWTUOoG https://t.co/YWG0TxRLCz","edit_history_tweet_ids":["2062710045121400853"]},{"id":"2062709992696725599","text":"💥 New job alert! 💥\n\n💼 Distinguished Product Designer\n📍 Remote (United States)\n💰 $203k - $325k\n\n🛠️ Data Science, Artificial Intelligence, Machine Learning, Scala\n🏢 👥 1K - 5K\n\nhttps://t.co/Lkuq7Ev4Oi\n\n#TechJobs","edit_history_tweet_ids":["2062709992696725599"]},{"id":"2062709986497560663","text":"RT @heyalexmoore: All Paid Courses (Free for First 4500 People)\n\n 𝗣𝗮𝗶𝗱 𝗖𝗼𝘂𝗿𝘀𝗲 𝗙𝗥𝗘𝗘 (PART - 1)\n 1. Artificial Intelligence\n 2. Machine Learn…","edit_history_tweet_ids":["2062709986497560663"]},{"id":"2062709955472363626","text":"RT @AP: Pope Leo XIV has issued a manifesto calling for robust regulation of artificial intelligence. His first encyclical, “Magnifica Huma…","edit_history_tweet_ids":["2062709955472363626"]},{"id":"2062709866817560986","text":"The energy transition should be leveraged as a catalyst for broader economic restructuring, with strategic focus areas including artificial intelligence (AI), semiconductors and data centres. #NSTBusinessTimes https://t.co/Qe4s6wwkaU","edit_history_tweet_ids":["2062709866817560986"]}],"meta":{"newest_id":"2062710080311644645","oldest_id":"2062709866817560986","next_token":"b26v89c19zqg8o3jueqgyfkwvtv7ij6ze2j1vku9n9z7h","result_count":10}}},"exampleRequest":{"query":"artificial intelligence","max_results":10},"tags":["x402"],"displayCostAmount":"0.052000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.052000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.052","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.052","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nnh4Q5uBUuq_9Uu_Ya1m9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.052","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches recent tweets on X/Twitter using the v2 API search endpoint, returning up to 100 matching tweets for a given query","exampleAgentPrompt":"Search recent tweets about 'OpenAI GPT-5' on X/Twitter and return up to 20 results — I want to see what people are saying about it right now.","exampleUseCases":[{"title":"Monitor brand mentions across social media","prompt":"Search Twitter for recent tweets mentioning our company name and see what customers are saying about us — I need to know if there's any negative sentiment I should address."},{"title":"Track competitor activity and industry news","prompt":"Look up the latest tweets about our main competitors and find any announcements they've made recently — I want to stay ahead of what they're doing in the market."},{"title":"Find relevant discussions for lead generation","prompt":"Search X for tweets from people talking about our product category and pain points we solve — help me identify potential customers who might be interested in what we offer."}],"resultDescription":"Returns a JSON object with an array of tweet data objects matching the search query, along with metadata including result count and pagination tokens. May also include an errors array if partial failures occurred.","failureModes":["Invalid or overly complex search query syntax returns a 400 error","Query returns zero results if no recent tweets match","Rate limit or quota exhaustion returns a 429 or payment-related error","Payment of 0.052 USDC not fulfilled returns a 402 Payment Required","max_results out of range (below 1 or above 100) causes validation error"],"whenToPreferThis":"Use this endpoint when you need to search recent tweets on X/Twitter via a pay-per-call model without managing your own Twitter API credentials or subscription. Ideal for agents that need on-demand social media search with USDC micropayments via the x402 protocol. Prefer this over direct Twitter API access when you want frictionless metered access billed per search at $0.052 per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-05-17T18:30:17.924Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T22:41:22.030Z","isFirstParty":false}