TwitterAPIs Docs
API ReferenceTweet Details

Get Tweet by ID API | Twitter Tweet Lookup

Resolve a tweet ID into its complete object, including author, engagement counts, attached media, and any quoted tweet. The starting point for any single-tweet workflow. Cost: $0.0008 per call.

Tweet Detail resolves a tweet ID or status URL into its complete object: author, full text, created_at, attached media, any quoted tweet, and live engagement counts (likes, retweets, replies, quotes, bookmarks, views). It is a single $0.0008 read with bearer auth, the starting point for any single-tweet workflow.

GET
/tweet/detail

Authorization

bearerAuth
AuthorizationBearer <token>

Pass your API key as a bearer token on every request: Authorization: Bearer <API_KEY>.

In: header

Query Parameters

id?string

Numeric ID of the tweet to fetch. Provide either id or url.

url?string

Full status URL of the tweet, for example https://x.com/naval/status/1759123456789012345. Provide either id or url.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/tweet/detail?id=1759123456789012345&url=https%3A%2F%2Fx.com%2Fnaval%2Fstatus%2F1759123456789012345"
{  "id": "1759123456789012345",  "tweet": {    "id": "1759123456789012345",    "text": "Shipping the new docs today.",    "created_at": "Tue Feb 20 14:02:11 +0000 2026",    "author": {      "id": "745273",      "username": "naval",      "name": "Naval"    },    "favorite_count": 4821,    "retweet_count": 612,    "reply_count": 88,    "quote_count": 14,    "bookmark_count": 203,    "view_count": 219340  }}
{  "error": "bad_request",  "message": "Missing or malformed parameter. Fix the request before retrying."}
{  "error": "unauthorized",  "message": "The API key is missing, malformed, or revoked. Check the Authorization header."}
{  "error": "insufficient_credits",  "message": "Your balance is exhausted. Top up your credits to continue."}
{  "error": "not_found",  "message": "The resource does not exist, for example a deleted tweet or a private account."}
{  "error": "rate_limited",  "message": "Too many requests. Back off and retry with exponential backoff."}
{  "error": "server_error",  "message": "Something failed on our side. Retry with backoff; if it persists, contact support."}

Pricing

UnitPrice
Per call$0.0008
Per 1,000 calls$0.80

When to use

Use it to hydrate one tweet you already have an ID or URL for, for example enriching a stored tweet with current engagement counts.

FAQ

Can I look up a tweet by URL instead of ID?

Yes. Pass either id or url. The url accepts a full x.com status link, for example https://x.com/naval/status/1759123456789012345.

Does Tweet Detail return media and quoted tweets?

Yes. The resolved tweet object includes attached media and any quoted tweet, alongside the live engagement counts.

How much does one tweet lookup cost?

It is a single $0.0008 read. Resolving one tweet is one billed call, not a paginated sweep.