{"uid":"cap_mEQKWUgeuSgly2ocYNVd8","slug":"www-surplusintelligence-ai-c6b25a07","name":"Surplus Intelligence X/Twitter Tweet Lookup","description":"X/Twitter API v2 via Surplus Intelligence: Tweet lookup (1 unit)","url":"https://www.surplusintelligence.ai/x402/api/twitter/v2/tweets","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":["ids"],"properties":{"ids":{"type":"string","description":"Comma-separated X/Twitter tweet IDs."}},"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":["errors"],"properties":{"errors":{"type":"array","items":{"type":"object","required":["type","title","value","detail","parameter","resource_id","resource_type"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"detail":{"type":"string"},"parameter":{"type":"string"},"resource_id":{"type":"string"},"resource_type":{"type":"string"}}}}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"ids":"1234567890123456789"}}},"response":{"errors":[{"type":"https://api.twitter.com/2/problems/resource-not-found","title":"Not Found Error","value":"1234567890123456789","detail":"Could not find tweet with ids: [1234567890123456789].","parameter":"ids","resource_id":"1234567890123456789","resource_type":"tweet"}]}},"exampleRequest":{"ids":"1234567890123456789"},"tags":["x402"],"displayCostAmount":"0.0079","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.0079/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0079","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0079","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-XjpWz6ny-Dfj2xQRXuUl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0079","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches tweet data from Twitter/X API v2 by one or more tweet IDs via the Surplus Intelligence proxy","exampleAgentPrompt":"Can you look up the tweet with ID 1234567890123456789 and tell me what it says?","exampleUseCases":null,"resultDescription":"Returns a JSON object conforming to the Twitter API v2 tweet lookup response, including a 'data' array with tweet objects (text, id, and requested fields), an optional 'meta' object, and an 'errors' array if any IDs were invalid or not found.","failureModes":["Invalid or malformed tweet IDs return error objects in the 'errors' array","Deleted or suspended tweets may return not-found errors","Rate limits or quota exhaustion on the upstream Twitter API return 429 or proxy error responses","Missing required 'ids' query parameter returns a 400-level validation error","Payment failure via x402 protocol returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you have one or more specific tweet IDs and need to retrieve their content or metadata. Prefer this over tweet search when you already know the exact tweet IDs rather than searching by keywords or user. Ideal for agents resolving tweet references found elsewhere (e.g., in URLs or mentions).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:51:16.309Z","isFirstParty":false}