# X User Tweets API (https://www.socialcrawl.dev/platforms/twitter/user-tweets)

> Returns up to the 100 most recent tweets posted by a Twitter/X user. Each tweet includes the full text, like count, retweet count, reply count, media attachments, and creation timestamp. Pagination is not currently supported on this endpoint — the upstream provider returns a single page. For deeper history, combine this with `/v1/twitter/ai-search` or `/v1/search/everywhere`.

TL;DR: `GET /v1/twitter/user/tweets` 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 |
| --- | --- | --- |
| `handle` | yes | Twitter username without the @ symbol |
| `trim` | no | Set to true for a trimmed down version of the response |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/twitter/user/tweets?handle=elonmusk" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a user's tweets with an API?

Send a GET request to /v1/twitter/user-tweets with the handle parameter (no @ symbol). SocialCrawl returns an array of the user's recent tweets with full text, engagement counts, media attachments, and creation timestamps in a unified schema.

### What fields are returned per tweet?

Each tweet includes tweet ID, full text, like count, retweet count, reply count, quote count, media attachments (images, video URLs), language, creation timestamp, and a boolean flag for whether the tweet is a retweet or quote.

### Can I trim the response to save bandwidth?

Yes. Pass the optional trim=true parameter and the endpoint returns a lighter payload with just the essential fields. Useful when you only need text, IDs, and engagement counts for bulk collection jobs.

### How much does this endpoint cost?

One credit per request on the standard tier. New accounts get 100 free credits with no credit card required. There's no rate limit — you pay only for what you pull, and there is no monthly minimum or subscription required.

### Do I need an X API Pro subscription to read tweets?

No. SocialCrawl doesn't use the official X API, so you don't need Pro, Basic, or Enterprise access. Send your x-api-key and a handle — public tweet data comes back directly without a developer portal.

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 get a user's tweets without the X API
- Best alternative to twitter API Pro tier