scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTThread
  • POSTSearch
  • POSTUser Tweets
  • POSTUser Info

Twitter Thread

2 credits

Fetch a Twitter thread with comments.

POST/api/v1/tools/twitter/thread

Parameters

urlstringrequired

Full Twitter/X thread URL (e.g. "https://x.com/elonmusk/status/1234567890").

maxCommentsnumber

Maximum number of comments to return. Must be a positive integer. Defaults to 200. Upper bound is determined by your plan.

fieldsstring[]

Fields to include per reply. Omit for defaults: id, author, content, publishedAt, likesCount, repliesCount, retweetsCount, viewsCount, conversationId, inReplyToStatusId, inReplyToScreenName, lang, entities. Available fields: id, author, content, publishedAt, likesCount, repliesCount, retweetsCount, viewsCount, bookmarkCount, quoteCount, conversationId, inReplyToStatusId, inReplyToUserId, inReplyToScreenName, source, lang, entities. Use ["*"] for all fields.

Response Schema

dataobject

Twitter thread result

postobject

Original tweet metadata

commentsobject[]

Array of reply comment objects.

countnumber

Number of comments returned

totalCommentsnumber | null

Total reply count reported by Twitter

truncatedboolean

True if more comments exist than were returned. Only present when truncation occurred.

metaobject

Request metadata

toolstring

Tool name (twitter-thread)

creditsUsednumber

Credits consumed (2)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/twitter/thread \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://x.com/elonmusk/status/1234567890",
    "maxComments": 50
  }'

Response Example

{
  "data": {
    "post": {
      "id": "1234567890",
      "author": "elonmusk",
      "text": "Excited to announce a major update to our platform. Here is what is changing and why it matters.",
      "createdAt": "2026-04-10T14:00:00.000Z",
      "url": "https://x.com/elonmusk/status/1234567890",
      "likes": 45200,
      "retweets": 8730,
      "replies": 3100
    },
    "comments": [
      {
        "id": "1234567891",
        "parentId": "1234567890",
        "author": "techfan42",
        "text": "This is a great improvement. Looking forward to trying it out.",
        "createdAt": "2026-04-10T14:05:00.000Z",
        "likes": 128
      }
    ],
    "count": 1,
    "totalComments": 3100,
    "truncated": true
  },
  "meta": {
    "tool": "twitter-thread",
    "creditsUsed": 2,
    "requestId": "req_abc123"
  }
}