{"uid":"cap_bit2YzBKBWc5cVAFYT1wG","slug":"x402-twit-sh-4a0ab01c","name":"x402.twit.sh Bulk Tweet Lookup","description":"Bulk look up multiple Twitter/X tweets by their numeric tweet IDs in a single request. Each tweet includes full text, author profile, and engagement metrics. Query param: ids (string, required) - comma-separated numeric tweet IDs, max 50, e.g. GET /tweets?ids=1110302988,1234567890. Returns X v2 API-compatible JSON.","url":"https://x402.twit.sh/tweets?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["ids"],"properties":{"ids":{"type":"string","description":"Comma-separated numeric tweet IDs, max 50"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":[{"id":"1110302988","text":"Running bitcoin","author":{"id":"9253672","name":"Hal Finney","username":"halfin"},"created_at":"2009-01-11T03:39:18.000Z","public_metrics":{"like_count":134000,"quote_count":3500,"reply_count":5400,"retweet_count":32000}}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"ids":"1110302988,1234567890,9876543210"}},"output":{"type":"object"}},"response":{"data":[{"id":"1110302988","lang":"en","text":"Running bitcoin","author":{"id":"9253672","name":"halfin","entities":{"description":{}},"location":"Santa Barbara, CA","username":"halfin","verified":true,"protected":false,"created_at":"2007-10-04T22:29:39.000Z","description":"","verified_type":"blue","public_metrics":{"like_count":1,"media_count":3,"tweet_count":66,"listed_count":780,"followers_count":151712,"following_count":29},"pinned_tweet_id":"1110302988","profile_image_url":"https://pbs.twimg.com/profile_images/287413224/hal_normal.jpg","profile_banner_url":""},"author_id":"9253672","created_at":"Sun Jan 11 03:33:52 +0000 2009","public_metrics":{"like_count":133862,"quote_count":14087,"reply_count":11669,"retweet_count":44688,"bookmark_count":11524},"reply_settings":"everyone","conversation_id":"1110302988","possibly_sensitive":false,"edit_history_tweet_ids":["1110302988"]},{"id":"1234567890","lang":"el","text":"Αρσεναλ - Σάντερλαντ: (X) 0-0 τελικό","author":{"id":"18934481","name":"Pathfinder Sports","entities":{"url":{"urls":[{"url":"http://t.co/qbweZ7AFAI","indices":[0,22],"display_url":"news.pathfinder.gr/sports","expanded_url":"http://news.pathfinder.gr/sports"}]},"description":{}},"location":"Heraklion, Crete","username":"pathfinderSport","verified":false,"protected":false,"created_at":"2009-01-13T10:15:21.000Z","description":"Αθλητικά νέα από το Pathfinder Sports","public_metrics":{"like_count":0,"media_count":0,"tweet_count":109506,"listed_count":32,"followers_count":3430,"following_count":6},"profile_image_url":"https://pbs.twimg.com/profile_images/71248884/twitter-icons_normal.jpg","profile_banner_url":""},"author_id":"18934481","created_at":"Sat Feb 21 16:55:22 +0000 2009","public_metrics":{"like_count":7739,"quote_count":5745,"reply_count":14461,"retweet_count":5489,"bookmark_count":4975},"reply_settings":"everyone","conversation_id":"1234567890","possibly_sensitive":false,"edit_history_tweet_ids":["1234567890"]},{"id":"9876543210","lang":"tl","text":"@sansantan okeee (: heheh thankiee","author":{"id":"34513448","name":"Mariam","entities":{"description":{}},"location":"","username":"mpornx","verified":false,"protected":false,"created_at":"2009-04-23T03:17:18.000Z","description":"","public_metrics":{"like_count":1,"media_count":18584,"tweet_count":58770,"listed_count":6,"followers_count":773,"following_count":0},"profile_image_url":"https://pbs.twimg.com/profile_images/619704141904916480/Y3jdzdNb_normal.jpg","profile_banner_url":"https://pbs.twimg.com/profile_banners/34513448/1436645212"},"author_id":"34513448","created_at":"Tue Mar 02 14:34:56 +0000 2010","public_metrics":{"like_count":57,"quote_count":25,"reply_count":124,"retweet_count":36,"bookmark_count":1},"reply_settings":"everyone","conversation_id":"9876543210","possibly_sensitive":false,"edit_history_tweet_ids":["9876543210"]}]}},"exampleRequest":{"ids":"1110302988,1234567890,9876543210"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"1.00","reviews":1,"stars":"5.0","state":"rated"},"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_jFbNKsaWu_5AurEjshT6O","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Bulk fetch up to 50 Twitter/X tweets by their numeric IDs, returning full text, author profiles, and engagement metrics in a single request.","exampleAgentPrompt":"Can you pull the full details — text, author, and engagement metrics — for these tweet IDs: 1110302988, 1234567890, and 9876543210?","exampleUseCases":null,"resultDescription":"Returns an X v2 API-compatible JSON object containing an array of tweet objects, each with full tweet text, author profile information (username, display name, profile data), and engagement metrics (likes, retweets, replies, quotes) for each requested tweet ID.","failureModes":["Invalid or non-numeric tweet IDs return an error response","More than 50 IDs submitted causes a validation error","Deleted or suspended tweet IDs return empty or null entries","Malformed comma-separated string causes a parse error","Payment failure (402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you have a known list of tweet IDs (up to 50) and need their full content, author profiles, and engagement metrics in one call. Prefer this over single-tweet lookups when processing multiple tweets at once to save on API calls and cost. Ideal for analytics pipelines, content archiving, or enriching datasets that already contain tweet IDs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-07-15T21:55:30.307Z","lastSuccessfullyRanAt":"2026-07-15T21:55:30.307Z","lastHealthCheckAt":"2026-10-29T13:01:33.336Z","isFirstParty":false,"canonicalSlug":"x402-twit-sh-4a0ab01c"}