X/Twitter API

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

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

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.

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

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

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

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

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: cursor pagination is now live on all list endpoints.",
      "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: cursor pagination is now live on all list endpoints.",
      "posted_at": "2026-07-06T08:15:00Z",
      "metrics": {
        "views": 90211,
        "likes": 1211,
        "reposts": 204,
        "replies": 88
      }
    }
  ],
  "meta": {
    "count": 2,
    "limit": 20,
    "cursor": "eyJwYWdlIjoyfQ",
    "has_more": true,
    "item": "tweet"
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

Related: LinkedIn API · Rate limits · Field projection