{"uid":"cap_VpfgrerVqHzlncNncPbrp","slug":"agentutility-tweets-by-id-lookup-1f0ee1a8","name":"AgentUtility Tweets by ID Lookup","description":"Tweets by ID API / bulk Twitter tweet lookup / X post IDs lookup. Same backend as tweets, listed for agents that already have tweet IDs and need public text, metrics, and author context.","url":"https://x402.agentutility.ai/tweets-by-id","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":["ids"],"properties":{"ids":{"type":"array","items":{"type":"string"},"description":"Numeric X/Twitter tweet IDs. Up to 100."},"mode":{"enum":["tweets"],"type":"string","description":"Optional. Operation mode; defaults to 'tweets' when tweet_ids/ids are supplied. Accepts search, user, tweets, users, or user_tweets."},"tweet_ids":{"type":"array","items":{"type":"string"},"description":"Alias for ids."}}},"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"},"requested":{"type":"integer"},"result_count":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"mode":"tweets","source":"X API v2 tweet lookup","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_wPoaDfxelGJtUeO1vXZv5","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 text, engagement metrics, and author context for one or more Twitter/X post IDs in bulk","exampleAgentPrompt":"I have a list of tweet IDs — 1823456789012345678, 1823456789012345679, 1823456789012345680 — can you fetch the full text, like counts, retweet counts, and author usernames for all of them?","exampleUseCases":[{"title":"Hydrate scraped tweet IDs for analysis","prompt":"I scraped a bunch of tweet IDs from a trending hashtag — here they are: 1823456789012345678, 1823456789012345679, 1823456789012345680. Can you pull the full tweet text, impression counts, and author handles for each so I can analyze what's being said?"},{"title":"Verify tweet content before quoting","prompt":"Before I quote these tweets in my report, can you fetch the actual text and author names for these tweet IDs: 1823456789012345678 and 1823456789012345679? I want to make sure I have the exact wording and correct attribution."},{"title":"Monitor engagement on known posts","prompt":"I'm tracking how these specific tweets are performing — IDs 1823456789012345678, 1823456789012345679, and 1823456789012345680. Can you get the current like, retweet, and reply counts for each of them?"}],"resultDescription":"Returns a list of hydrated tweet objects for each input ID, including the full public tweet text, engagement metrics (likes, retweets, replies, impressions), author username, display name, and account metadata. Tweets that are deleted, private, or invalid return an appropriate error or null entry per ID.","failureModes":["Invalid or malformed tweet ID returns an error or null entry for that ID","Deleted or suspended tweet returns not-found error","Private/protected account tweets return access-denied error","Rate limits or upstream Twitter API errors may cause partial or full failure","Payment failure via x402 protocol blocks the request entirely","Empty ID list or missing required parameter returns 400 bad request"],"whenToPreferThis":"Choose this endpoint when you already have specific tweet IDs and need to retrieve their full content, metrics, and author data in one bulk call. It is ideal for hydrating IDs collected from prior searches, scrapes, or references — avoiding the need to re-search. Prefer this over a tweet search endpoint when you know exactly which tweets you want and need reliable direct lookup rather than keyword-based discovery.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:13:21.364Z","isFirstParty":false}