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

> Returns the tweets on a Twitter/X account's Media tab: only the tweets carrying a photo or video. Each tweet includes the full text, media attachment URLs, like count, retweet count, reply count, author info, and creation timestamp; view and bookmark counts are not available on this surface and return null. Page size is set by the source. Deeper history is a cursor walk: send `pagination.next_cursor` back as `cursor` and repeat until `pagination.has_more` is false; each page costs 1 credit.

TL;DR: `GET /v1/twitter/user/media` 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 |
| `cursor` | no | Cursor from the previous response's pagination.next_cursor to fetch the next page |

## Code example

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

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