# 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, media attachments, author info, and creation timestamp.

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 |
| `trim` | no | Set to true for a trimmed down version of the response |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/twitter/tweet?url=https%3A%2F%2Fx.com%2Felonmusk%2Fstatus%2F1234567890" \
  -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 context with author info and engagement metrics. Reply threads return the parent tweet ID so you can walk the chain.

### 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?

Yes. Pass trim=true to get a lighter payload with only the essential fields. Useful when you only need tweet text and engagement counts for large-scale monitoring or dashboard jobs where every KB counts.

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