# Scrapier — X (Twitter) API > Scrapier endpoints for X (Twitter): Twitter/X Posts, X/Twitter Video Transcript, Twitter/X Profile Tweets. Base URL: https://api.scrapier.io/api/v2 · Auth: header `X-API-Key: ` · Synchronous: HTTP 200 returns {"success": true, "data": {...}} · Paginate by sending data.next_cursor back as `cursor` until it is null · Paths keep the trailing slash. Live parameter source (no auth): https://api.scrapier.io/api/v2/endpoints · Docs: https://docs.scrapier.io/api-reference/twitter.md ## GET /twitter-post/ Twitter/X Posts: Structured X (Twitter) data: send `usernames`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.tweets Parameters: - usernames (required, string, example elonmusk): X/Twitter post URL or post id (returns that one post), or username / profile URL / numeric user ID (latest posts, ~20 per page). Required on first call; ignored when `cursor` is supplied. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/twitter-post/?usernames=elonmusk" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/twitter/twitter-post.md ## GET /twitter-transcript/ X/Twitter Video Transcript: Structured X (Twitter) data: send `urls`. Single lookup, 2 credits per successful call. Cost: 2 credits per successful call · Pagination: single lookup · Results: data.transcript · Long-running (client timeout 210 s or more) Parameters: - urls (required, string, example https://x.com/MrBeast/status/2096285173788840001): Tweet/X post URL. Lookup endpoint -- next_cursor null. - translate_to_english (optional, boolean, default false): Translate transcript to English. - model_size (optional, string, one of: tiny|base|small|medium|large-v3, default small): faster-whisper model size. - beam_size (optional, integer, default 5): Beam search width (1-10). - language (optional, string): ISO language code to force (default: auto-detect). - vad_filter (optional, boolean, default true): Drop non-speech audio. - max_duration_seconds (optional, integer, default 900): Longer videos fail as a record. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/twitter-transcript/?urls=https%3A%2F%2Fx.com%2FMrBeast%2Fstatus%2F2096285173788840001" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/twitter/twitter-transcript.md ## GET /twitter-tweets/ Twitter/X Profile Tweets: Structured X (Twitter) data: send `usernames`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.tweets Parameters: - usernames (required, string, example elonmusk): X handle, numeric user ID, or profile URL. Required on first call; ignored when `cursor` is supplied. Keyword/hashtag search is login-only on X and returns 400. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - with_replies (optional, boolean, default true): Include replies in the result. Locked into the cursor. - include_user_info (optional, boolean, default true): Include per-tweet user info. Locked into the cursor. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/twitter-tweets/?usernames=elonmusk" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/twitter/twitter-tweets.md