Data APIs / X (Twitter)

X / Twitter Scraper API

Profiles, post timelines, single posts with their threads, and replies from X — formerly Twitter — with likes, reposts, views, media, and quoted posts, without X's paid API or a logged-in account. Endpoints live under /social/x; "X" and "Twitter" mean the same platform everywhere in the docs.

From 1 credit per call · cache hits free · failed calls refunded · no card for the free tier

One request, structured data and markdown

Every endpoint accepts format=json, markdown, or both. Use the JSON to filter and store; drop the markdown straight into a prompt.

  • Profile: followers, following, post count, bio, website, join date, verification type, "based in" country
  • Timeline: ~20 posts per page, newest first, with likes / reposts / replies / quotes / bookmarks / views
  • Single post with media, quoted post, community note, and the author's unrolled thread
  • Replies with authors and reply-to links, ranked by relevance, recency, or likes
  • Cursor pagination on timelines and replies
request
curl 'https://scrapewhale.dev/api/v1/social/x/tweets?handle=huel&format=json' \
  -H 'Authorization: Bearer <api-key>'
response · json
{
  "extractor": "twitter-tweets",
  "creditsCharged": 1,
  "data": {
    "handle": "huel",
    "count": 19,
    "next_cursor": "DAAHCgABHQ2a-FD…",
    "tweets": [
      {
        "id": "2080284119838204327",
        "url": "https://x.com/huel/status/2080284119838204327",
        "text": "Let it be noted for the record…",
        "created_timestamp": 1784813358,
        "author": { "handle": "huel", "name": "Huel", "verified": true, "followers": 21698 },
        "likes": 13, "reposts": 2, "replies": 6, "quotes": 0, "views": 1633,
        "media": [], "quoted_tweet": null
      }
    ]
  }
}

Abridged.

Endpoints

4 endpoints in this family. Full parameter reference and a try-it console are in the API docs.

get/api/v1/social/x/profile1 credit

X (Twitter) profile

X (formerly Twitter) profile: followers, following, post and media counts, bio, website, location, join date, verification type, and the "based in" country from X's About-this-account panel. No X API key or login. "X" and "Twitter" refer to the same platform throughout.

handle
X handle, with or without the leading @. Provide this or url.
url
An x.com/<handle> or twitter.com/<handle> profile URL.
get/api/v1/social/x/tweets1 credit

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).

handle
X handle, with or without the leading @. Provide this or url.
url
An x.com/<handle> profile URL.
cursor
next_cursor from the previous page.
with_replies
true to include the account's replies (the "Posts & replies" tab).
get/api/v1/social/x/tweet1 credit

X (Twitter) single post + thread

One X (Twitter) post with full engagement counts, media, the quoted post if any, and the author's own unrolled thread (1/n, 2/n, …). X Articles (long-form posts) come with their full body as article (markdown, text, images) and are rendered in the markdown output. Accepts a post id or an x.com/<handle>/status/<id> URL.

id
Numeric post id. Provide this or url.
url
An x.com/<handle>/status/<id> URL.
get/api/v1/social/x/replies1 credit

X (Twitter) replies to a post

Replies from other users to an X (Twitter) post, as structured posts with author, engagement, and replying_to so you can rebuild the tree. The original post is included on the first page. Paginate with next_cursor. X hides some low-quality replies from logged-out viewers, so fewer replies than the post's reply count is normal.

id
Numeric post id. Provide this or url.
url
An x.com/<handle>/status/<id> URL.
cursor
next_cursor from the previous page.
ranking
relevance (X's default ordering), recency, or likes.

What teams use it for

Competitor voice monitoring

Pull a competitor's posts weekly and let your agent summarise launches, offers, and tone.

Social proof and sentiment

Read the replies to a launch post to see how the market actually reacted.

Creator and account vetting

Check followers, verification, account age, and where an account is really based.

Frequently asked questions