curl -X GET "https://scrape.st/x/user-timeline?username=elonmusk" \
-H "x-api-key: YOUR_API_KEY"
curl -X GET "https://scrape.st/x/user-timeline?username=elonmusk&cursor=DAABCgABGc..." \
-H "x-api-key: YOUR_API_KEY"
{
"tweets": [
{
"id": "1858123456789012345",
"text": "Example post content",
"author": {
"username": "elonmusk",
"name": "Elon Musk"
},
"createdAt": "2026-06-11T18:24:00.000Z"
}
],
"nextCursor": "DAABCgABGc7hF0lAAAAACgACGc..."
}
X Queries
User Timeline
Get the latest posts from any X account with cursor pagination
GET
/
x
/
user-timeline
curl -X GET "https://scrape.st/x/user-timeline?username=elonmusk" \
-H "x-api-key: YOUR_API_KEY"
curl -X GET "https://scrape.st/x/user-timeline?username=elonmusk&cursor=DAABCgABGc..." \
-H "x-api-key: YOUR_API_KEY"
{
"tweets": [
{
"id": "1858123456789012345",
"text": "Example post content",
"author": {
"username": "elonmusk",
"name": "Elon Musk"
},
"createdAt": "2026-06-11T18:24:00.000Z"
}
],
"nextCursor": "DAABCgABGc7hF0lAAAAACgACGc..."
}
Returns the most recent posts authored by an X account (up to 20 per page). Retweets are excluded — only the account’s own posts are returned. Each entry is a fully hydrated tweet payload, identical in shape to the Post Data response.
This endpoint is rate-limited to 10 requests per 60 seconds.
Query Parameters
string
required
The X username (handle) to fetch the timeline for, without the
@.string
Pagination cursor from a previous response’s
nextCursor. Omit to fetch the
first page.Response
array
Array of tweet payloads, newest first. Empty when the account has no posts or
the page is exhausted.
string | null
Cursor for the next page. Pass it as the
cursor query parameter on the next
request. null when there are no further pages.curl -X GET "https://scrape.st/x/user-timeline?username=elonmusk" \
-H "x-api-key: YOUR_API_KEY"
curl -X GET "https://scrape.st/x/user-timeline?username=elonmusk&cursor=DAABCgABGc..." \
-H "x-api-key: YOUR_API_KEY"
{
"tweets": [
{
"id": "1858123456789012345",
"text": "Example post content",
"author": {
"username": "elonmusk",
"name": "Elon Musk"
},
"createdAt": "2026-06-11T18:24:00.000Z"
}
],
"nextCursor": "DAABCgABGc7hF0lAAAAACgACGc..."
}