Skip to content
ScraperSocial API

X/Twitter API

Six endpoints under /v1/twitter/* (the path uses twitter; x.com and twitter.com URLs are both accepted as input). All are GET, authenticated with Authorization: Bearer sk_live_..., and return the standard { data, meta?, request_id } envelope.

GET /v1/twitter/transcript

Full transcript of a video attached to a post on X.

Availability: Caption-dependent: transcripts are available only when the video has captions on X, which most videos don't. When no captions exist the API returns a 404 no-transcript error, and failed calls are never charged.

Credits: 7 per video · Caching: Cached forever

Parameters

Name Description
url required Public X/Twitter content URL.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/twitter/transcript?url=https%3A%2F%2Fx.com%2FXDevelopers%2Fstatus%2F1861122334455667788" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "twitter",
    "entity_id": "1861122334455667788",
    "language": "en",
    "source": "audio",
    "text": "Today I want to show you the three settings everyone ignores when they set this up for the first time...",
    "segments": [
      {
        "start": 0,
        "end": 3.2,
        "text": "Today I want to show you the three settings"
      },
      {
        "start": 3.2,
        "end": 5.9,
        "text": "everyone ignores when they set this up"
      }
    ]
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/twitter/summary

Short AI summary of a video posted on X, built on its transcript.

Availability: Caption-dependent: summaries are built from the video's transcript, so they're available only when the video has captions on X — most don't. When no captions exist the API returns a 404 no-transcript error, and failed calls are never charged.

Credits: 9 per video · Caching: Cached forever

Parameters

Name Description
url required Public X/Twitter content URL.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/twitter/summary?url=https%3A%2F%2Fx.com%2FXDevelopers%2Fstatus%2F1861122334455667788" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "twitter",
    "entity_id": "1861122334455667788",
    "language": "en",
    "summary": "A quick tutorial covering three commonly missed configuration steps, with a before/after comparison and a call to check the pinned comment for the full guide."
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/twitter/stats

Views, likes, reposts and replies for a single post on X.

Credits: 1 per tweet · Caching: Age-aware cache (15 min - 7 days)

Parameters

Name Description
url required Public X/Twitter content URL.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/twitter/stats?url=https%3A%2F%2Fx.com%2FXDevelopers%2Fstatus%2F1861122334455667788" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "twitter",
    "entity_id": "1861122334455667788",
    "url": "https://x.com/XDevelopers/status/1861122334455667788",
    "author": {
      "handle": "XDevelopers",
      "name": "Example Creator"
    },
    "posted_at": "2026-06-30T14:05:00Z",
    "metrics": {
      "views": 1204593,
      "likes": 88410,
      "comments": 2314,
      "shares": 10092
    }
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/twitter/profile

Follower counts, bio and profile metadata for an account on X.

Credits: 5 per lookup · Caching: Cached 12 hours

Parameters

Name Description
handle required Public X/Twitter handle (without @).
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/twitter/profile?handle=XDevelopers" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "twitter",
    "handle": "XDevelopers",
    "name": "Example Creator",
    "bio": "Tutorials and behind-the-scenes. New video every Tuesday.",
    "verified": true,
    "metrics": {
      "followers": 2450318,
      "following": 132,
      "posts": 842
    }
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/twitter/tweets

Latest posts from an account on X with per-post metrics.

Credits: 1 per tweet · Caching: Cached 3 hours (page 1: 1 hour) · Paginated (cursor/limit)

Parameters

Name Description
handle required Public X/Twitter handle (without @).
limit optional Items per page (default 20, max 50 sync; larger via async jobs).
cursor optional Opaque cursor from the previous page's meta.cursor.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/twitter/tweets?handle=XDevelopers" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": [
    {
      "id": "1861122334455667788",
      "url": "https://x.com/XDevelopers/status/1861122334455667788",
      "text": "Shipping notes: response times are down 40% after this week's cache work.",
      "posted_at": "2026-07-06T08:15:00Z",
      "metrics": {
        "views": 90211,
        "likes": 1211,
        "reposts": 204,
        "replies": 88
      }
    },
    {
      "id": "18611223344556677881",
      "url": "https://x.com/XDevelopers/status/1861122334455667788",
      "text": "Shipping notes: response times are down 40% after this week's cache work.",
      "posted_at": "2026-07-06T08:15:00Z",
      "metrics": {
        "views": 90211,
        "likes": 1211,
        "reposts": 204,
        "replies": 88
      }
    }
  ],
  "meta": {
    "count": 2,
    "limit": 20,
    "item": "tweet"
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

Keyword and advanced-search over public posts on X.

Credits: 2 per result · Caching: Age-aware cache (15 min - 7 days) · Paginated (cursor/limit)

Parameters

Name Description
query required Search keywords.
limit optional Items per page (default 20, max 50 sync; larger via async jobs).
cursor optional Opaque cursor from the previous page's meta.cursor.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/twitter/search?query=coffee%20brewing" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": [
    {
      "id": "1861122334455667788",
      "url": "https://x.com/XDevelopers/status/1861122334455667788",
      "text": "Cursor pagination is now live on every list endpoint.",
      "posted_at": "2026-07-06T08:15:00Z",
      "metrics": {
        "views": 90211,
        "likes": 1211,
        "reposts": 204,
        "replies": 88
      }
    },
    {
      "id": "18611223344556677881",
      "url": "https://x.com/XDevelopers/status/1861122334455667788",
      "text": "Cursor pagination is now live on every list endpoint.",
      "posted_at": "2026-07-06T08:15:00Z",
      "metrics": {
        "views": 90211,
        "likes": 1211,
        "reposts": 204,
        "replies": 88
      }
    }
  ],
  "meta": {
    "count": 2,
    "limit": 20,
    "item": "result"
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

Related: LinkedIn API · Rate limits · Field projection