Skip to content
Scrappa Get API key
X (Twitter) API 1 credit/request

X (Twitter) User Tweets

GET https://scrappa.co/api/x-twitter/user/tweets

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

X (Twitter) User Tweets 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/x-twitter/user/tweets
Auth header
x-api-key
Cost
1 credit/request
handle = example
Response preview
200 OK
{
    "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,
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

5 optional filters available.

handle string Required

Screen name, with or without the leading @.

Example value example
cursor string Optional

Opaque cursor from the previous page. Pagination is driven by this value; the returned result count is the authoritative page size.

Example value 0
count integer Optional

Requested page size. Advisory only: the upstream sets the page size, so the returned result count is what matters.

Example value 10
with_replies boolean Optional

Include replies in the timeline.

Example value true
groupthreads boolean Optional

Group the self-thread continuations of a tweet into a single timeline entry.

Example value true
since string Optional

Only tweets after this point in time.

Example value example

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

count cursor results

Common results fields

id text media views
JSON Response
200 OK
{
    "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"
        }
    ]
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.