{"uid":"cap_a-7bee8sRc19Bi_z8-Zt9","slug":"socialfetch-tweet-lookup-1ad4fd4d","name":"SocialFetch Tweet Lookup","description":"Get a single tweet by URL.","url":"https://api.socialfetch.dev/v1/twitter/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"],"type":"string"},"queryParams":{"type":"object","required":["url"],"properties":{"url":{"type":"string","maxLength":4096,"minLength":1,"description":"Tweet permalink or numeric id."},"trim":{"type":"boolean","description":"Optional: omit the author profile card for a smaller response."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.014","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.014/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5d723pnzAxnSgQrR5R4-o","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.014","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a single tweet's data by its permalink URL from the Twitter/X platform.","exampleAgentPrompt":"Can you pull the tweet from this link for me — https://twitter.com/elonmusk/status/1234567890 — and show me what it says along with the author info?","exampleUseCases":[{"title":"Monitor competitor mentions and engagement","prompt":"Check this tweet for me and grab the engagement numbers — https://twitter.com/techcrunch/status/1234567890 — I need to see how many likes and replies it's getting."},{"title":"Verify quotes in news articles","prompt":"I found this tweet quoted in an article but I want to confirm the exact wording. Can you pull the full text from https://twitter.com/nytimes/status/1234567890 so I can fact-check it?"},{"title":"Archive important announcements with metadata","prompt":"Pull the data from this product announcement tweet — https://twitter.com/productlaunch/status/1234567890 — I want to save the content, when it was posted, and who shared it for our records."}],"resultDescription":"Returns a structured object containing the tweet's text content, author profile information (handle, display name, avatar), tweet core metadata (timestamp, engagement counts), and any media attachments. With the optional `trim` flag set to true, the author profile and core metadata are omitted for a leaner response.","failureModes":["Invalid or malformed tweet URL returns a 400 error","Tweet has been deleted or made private returns a 404 or access-denied error","Rate limiting or payment failure returns a 402 or 429 error","Twitter/X platform outage causes upstream timeout or 503","URL pointing to a non-tweet page (e.g. a profile) causes unexpected or empty result"],"whenToPreferThis":"Use this endpoint when you need structured data for a single, specific tweet identified by its permalink URL — ideal for monitoring, archiving, fact-checking, or enriching tweet links shared by users. Prefer this over scraping when you need reliable, structured JSON output without browser automation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:57:28.141Z","isFirstParty":false}