Social Fetch
Start for freeStart free
X (Twitter) hub

X (Twitter) Tweet API

Resolve a public tweet URL (or numeric id) to structured post text, engagement metrics, and optional author profile in the shared Social Fetch envelope.

GET /v1/twitter/tweets

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/twitter/tweets is the single-post lookup. Pass url as a tweet permalink (x.com or twitter.com /status/...) or a bare numeric tweet id, send x-api-key, and branch on data.lookupStatus before you write. On found, data.tweet holds id, url, text, language, createdAt, metrics (views, favorites, retweets, replies, bookmarks, quotes), media, entities, and quote/reply/repost fields when X exposes them. data.author mirrors a public profile card plus metrics, and data.replies holds the first page of replies with data.repliesPage to continue them on GET /v1/twitter/tweets/replies. Set trim=true for a smaller body without author or replies.

This route fetches one post. Timeline pages for a handle are GET /v1/twitter/profiles/{handle}/tweets. Thread replies are GET /v1/twitter/tweets/replies. Spoken text from a video tweet is GET /v1/twitter/tweets/transcript. Bill from meta.creditsCharged.

X (Twitter) Tweet API FAQ

How do I fetch a single X / Twitter tweet by URL?

Call GET /v1/twitter/tweets with your Social Fetch API key in the x-api-key header and a required url query param (tweet permalink or numeric id). Read data.lookupStatus, then data.tweet and data.author when the post is available. See the API docs for parameters and examples.

How many credits does a Twitter tweet lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

What does the tweet response include?

On a found lookup, data.tweet includes id, public url, text, language, timestamps, engagement metrics, media, entities, link preview card, poll, article, tagged place, Community Note, and flags for reply, quote, and retweet when present. data.author is a profile card plus aggregate metrics, and data.replies is the first page of replies. Pass data.repliesPage.nextCursor as cursor to GET /v1/twitter/tweets/replies for more. trim=true omits the author and replies. Exact field lists and nullability live in the OpenAPI schema for this route.

What is the trim query parameter?

Optional trim=true returns a smaller payload: author is null and replies are omitted. Use it when you only need post text and metrics and want less JSON per call.

What happens if the tweet is deleted or unavailable?

Branch on data.lookupStatus. not_found means Social Fetch could not return a public post for that url. Do not invent text or metrics. Keep meta.requestId if you need support on a failed lookup.

Tweet by URL vs profile tweets vs replies vs transcript?

Use this route when you already have a status link or id. Use GET /v1/twitter/profiles/{handle}/tweets to page a handle's timeline. Use GET /v1/twitter/tweets/replies for replies under a status. Use GET /v1/twitter/tweets/transcript for spoken text on video tweets. They are separate marketplace operations with their own credit notes.

Do I need an X developer account for this endpoint?

No. Authenticate with your Social Fetch API key only. You do not create an X developer app or pass X Bearer tokens for this public tweet lookup.

Other X (Twitter) endpoints