# X Tweet API (https://www.socialcrawl.dev/platforms/twitter/tweet)

> Returns detailed information about a specific tweet including the full text, like count, retweet count, reply count, quote count, bookmark count, view count, media attachments, author info, and creation timestamp. A reply carries `post.ext.in_reply_to_id` and `post.ext.in_reply_to_username`, and `post.ext.conversation_id` is the id of the post that opened its thread (the tweet's own id when it starts one). Any handle in the URL path is ignored: X serves a status by its numeric id, so the author reported here is the one the platform returns, which can differ from the handle you sent.

TL;DR: `GET /v1/twitter/tweet` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Full URL of the tweet. The numeric status id is what identifies it; the handle in the path is not checked |
| `trim` | no | Accepted for backwards compatibility and ignored. It shrank the raw upstream payload, which the canonical response never exposed, so it changed nothing you can see and cost the author details |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/twitter/tweet" \
  --data-urlencode "url=https://x.com/NASA/status/2073078061499617543" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get tweet details from a URL?

Send a GET request to /v1/twitter/tweet with the full tweet URL in the url parameter. SocialCrawl returns the complete tweet object: text, engagement counts, media, author info, and timestamps in a unified JSON schema.

### What fields come back per tweet?

The response includes tweet ID, full text, like count, retweet count, reply count, quote count, view count (when public), media URLs, author handle, author display name, language, and precise creation timestamp.

### Does this endpoint work for quote tweets and replies?

Yes. Pass any tweet URL (original posts, quote tweets, or replies) and the response includes the full tweet with author info and engagement metrics. To walk a reply chain, call GET /v1/twitter/tweet/replies, which returns comment.parent_id on every row. The singular tweet endpoint does not publish a parent id.

### How much does getting a tweet cost?

One credit per tweet on the standard tier. New accounts get 100 free credits with no credit card required, so you can pull around 100 tweets before paying. There's no monthly subscription and no rate limit.

### Can I reduce the response size?

No. trim=true is accepted on this endpoint for backwards compatibility and is ignored. It only ever shrank the raw upstream payload, which the unified JSON never exposed. Send the same request without it.

See the full X API: https://www.socialcrawl.dev/platforms/twitter

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to fetch a tweet by URL with an API
- Get tweet data without the X API developer portal