{"uid":"cap_ybKdv-oXy7sKc9aS_mFB6","slug":"x-twitter-bulk-tweet-lookup-via-x402-b43955cf","name":"X (Twitter) Bulk Tweet Lookup via x402","description":"Tweets API / bulk X tweet lookup / Twitter tweet IDs lookup. Read-only X API v2 tweet lookup endpoint using the exact buyer slug seen in market demand. Pass tweet_ids or ids and get public post text, timestamps, language, public metrics, and expanded author profile fields. Requires X_BEARER_TOKEN; no posting, replying, liking, following, or account mutation.","url":"https://x402.agentutility.ai/tweets?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["tweet_ids"],"properties":{"ids":{"type":"array","items":{"type":"string"},"description":"Alias for tweet_ids."},"mode":{"enum":["tweets"],"type":"string","description":"Use 'tweets' for bulk tweet lookup. Defaults to tweets when ids are supplied."},"tweet_ids":{"type":"array","items":{"type":"string"},"description":"Numeric X/Twitter tweet IDs. Up to 100."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"mode":{"type":"string"},"source":{"type":"string"},"tweets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"author":{"type":"object","properties":{"username":{"type":"string"}}}}}},"requested":{"type":"integer"},"result_count":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"mode":"tweets","source":"X API v2 tweet lookup","tweets":[{"id":"1800000000000000000","text":"x402 payments are live","author":{"username":"agentutility_ai"}}],"requested":2,"result_count":2}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Myksu5ug7FiTmUkZjueFr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches public tweet data (text, timestamps, language, metrics, author profile) for one or more tweet IDs using the X API v2, paid per-call via x402/USDC.","exampleAgentPrompt":"Can you look up these tweet IDs — 1234567890123456789, 9876543210987654321 — and give me the full text, like/retweet counts, author username, and the language each was posted in?","exampleUseCases":[{"title":"Verify viral tweet content","prompt":"I've got a list of tweet IDs that are supposedly going viral — can you pull the actual text, engagement numbers, and posting time for each so I can verify what they actually say?"},{"title":"Enrich social media dataset","prompt":"I have a CSV of tweet IDs collected from a research dataset. Can you fetch the full tweet text, author handle, and public metrics for each ID so I can enrich the dataset?"},{"title":"Monitor competitor mentions","prompt":"I tracked down the IDs of recent tweets mentioning our competitor's product launch — can you retrieve the text and engagement stats for those tweet IDs so I can analyze the reaction?"}],"resultDescription":"Returns an array of tweet objects for each requested ID, each containing: full post text, creation timestamp, detected language, public metrics (likes, retweets, replies, quote count), and expanded author profile fields (username, display name, profile details). Read-only; no mutations are performed.","failureModes":["Invalid or deleted tweet IDs return empty or error entries per ID","Missing or invalid X_BEARER_TOKEN results in 401 unauthorized","Rate limit exceeded on upstream X API v2 returns 429","Malformed request body (missing tweet_ids/ids field) returns 400 bad request","Private or suspended accounts' tweets are inaccessible and return not-found errors","x402 payment failure (insufficient USDC balance) prevents call from completing"],"whenToPreferThis":"Choose this endpoint when you already have specific tweet IDs and need to bulk-retrieve their content, metrics, and author info without maintaining your own X API credentials or USDC payment infrastructure. Ideal for AI agents that need pay-per-call, no-subscription access to X data on Base/USDC. Prefer over direct X API v2 calls when operating in an agentic/MCP environment with x402 micropayment settlement.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T18:57:32.127Z","isFirstParty":false,"canonicalSlug":"x-twitter-bulk-tweet-lookup-via-x402-b43955cf"}