Social

X (Twitter) posts timeline

One page (about 20) of an X (Twitter) account's posts, newest first, pinned post first — text, media, likes, reposts, replies, quotes, bookmarks, views, quoted posts, and reposts. Pass the returned next_cursor as cursor for the next page (each page is one credit).

Provide exactly one of: handle, url.

Credits: 1 (refunded on failure).

get/api/v1/social/x/tweets

Request

  • Base URL: https://scrapewhale.dev
  • URL: https://scrapewhale.dev/api/v1/social/x/tweets
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

handlestring

X handle, with or without the leading @. Provide this or url.

urlstring uri

An x.com/<handle> profile URL.

cursorstring

next_cursor from the previous page.

with_replies'true' | 'false'

true to include the account's replies (the "Posts & replies" tab).

format'json' | 'markdown' | 'both'

Response shape: "json" (structured data only), "markdown" (markdown only), or "both".

Response

Success.

idstring required
status'completed' required
extractorstring required

Extractor name, e.g. "traffic", "meta-ads", "instagram-profile".

titlestring nullable
sourceUrlstring nullable

Canonical public URL of the extracted source.

creditsChargedinteger required

0 when served from the shared cache.

cachedboolean

True when served from the shared extraction cache (free).

createdAtinteger required

Unix epoch milliseconds.

dataobject nullable

Raw structured payload from the source.

markdownstring

Clean markdown rendering of the payload.

Changes

No recorded changes to this operation across all 1 revision of this API.