# X (Twitter) User Tweets

<p>The tweets posted by an account. Pagination is cursor-driven and the returned result count is the authoritative page size.</p>

- **Documentation:** [https://scrappa.co/docs/x-twitter/x_twitter_user_tweets](https://scrappa.co/docs/x-twitter/x_twitter_user_tweets)
- **API group:** X (Twitter) API
- **Endpoint:** `GET https://scrappa.co/api/x-twitter/user/tweets`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | Yes | <p>Screen name, with or without the leading @.</p> |
| `cursor` | string | No | <p>Opaque cursor from the previous page. Pagination is driven by this value; the returned result count is the authoritative page size.</p> |
| `count` | integer | No | <p>Requested page size. Advisory only: the upstream sets the page size, so the returned result count is what matters.</p> |
| `with_replies` | boolean | No | <p>Include replies in the timeline.</p> |
| `groupthreads` | boolean | No | <p>Group the self-thread continuations of a tweet into a single timeline entry.</p> |
| `since` | string | No | <p>Only tweets after this point in time.</p> |

## Example response

```json
{
    "count": 1,
    "cursor": "DAABCgACF__sample_opaque_cursor",
    "results": [
        {
            "id": "1234567890123456789",
            "text": "Public tweet text.",
            "media": [
                {
                    "url": "https://pbs.twimg.com/media/example.jpg",
                    "type": "photo"
                }
            ],
            "views": 180000,
            "author": {
                "name": "Example Account",
                "screen_name": "example"
            },
            "quotes": 31,
            "replies": 88,
            "retweets": 512,
            "bookmarks": 120,
            "created_at": "Tue Mar 05 09:20:00 +0000 2026"
        }
    ]
}
```

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)