{ "openapi": "3.0.1", "info": { "title": "X (Twitter) Replies Scraper - Tweet Replies, No Login", "description": "Export public replies to X (Twitter) posts from tweet URLs or IDs. Each reply row has text, author profile (followers, bio, verified), likes, views, bookmarks, language and conversation IDs. Sort by relevance, recency or likes and resume big exports with a saved cursor. No login or cookies.", "version": "1.0", "x-build-id": "VTXhxfBS3B4J84GUI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~x-twitter-replies-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-x-twitter-replies-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/khadinakbar~x-twitter-replies-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-x-twitter-replies-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/khadinakbar~x-twitter-replies-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-x-twitter-replies-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "tweetUrls" ], "properties": { "tweetUrls": { "title": "Tweet URLs or IDs", "minItems": 1, "maxItems": 50, "type": "array", "description": "Use this when you need public replies from specific X (Twitter) posts. Enter full URLs like https://x.com/OpenAI/status/2065225362544726371 or numeric tweet IDs, up to 50 per run. This is not for keyword search or profile timelines.", "items": { "type": "string" } }, "rankingMode": { "title": "Reply ranking mode", "enum": [ "Relevance", "Recency", "Likes" ], "type": "string", "description": "Use this when choosing how X should order replies for each tweet. Relevance returns the default conversation ranking, Recency returns newer replies first, and Likes prioritizes liked replies. Defaults to Relevance. This does not scrape quote tweets or retweeters.", "default": "Relevance" }, "maxReplies": { "title": "Maximum replies", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Use this to cap the total reply rows saved across all input tweets. The actor stops before charging beyond this limit. Defaults to 100 and supports up to 5000. This is a hard billing and dataset cap, not a per-tweet target.", "default": 100 }, "minLikes": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Use this to keep only replies with at least this many likes, for example 10. Replies below the threshold are skipped and not charged. Defaults to 0 (keep all). This filters saved rows; it does not change how X ranks replies.", "default": 0 }, "language": { "title": "Reply language", "type": "string", "description": "Use this to keep only replies in one language. Enter a two-letter code such as en, es or de. Replies in other languages are skipped and not charged. Leave empty to keep every language.", "default": "" }, "maxPagesPerTweet": { "title": "Maximum pages per tweet", "minimum": 1, "maximum": 100, "type": "integer", "description": "Use this as a pagination safety valve for each tweet conversation. Each page holds a batch of replies; higher values follow the conversation deeper. Defaults to 10 and supports up to 100. This does not override maxReplies.", "default": 10 }, "startCursor": { "title": "Start cursor", "maxLength": 500, "type": "string", "description": "Use this when continuing one tweet from a previous RUN_SUMMARY nextCursors value. Paste the cursor string exactly as returned by the actor. Leave blank for a fresh run. This is not a tweet URL or tweet ID field." }, "dedupeReplies": { "title": "Dedupe replies", "type": "boolean", "description": "Use this to skip duplicate reply tweets across pages and input tweets. The Actor dedupes by reply ID first, then reply URL or text. Defaults to true. Disable only when you need to inspect page overlap.", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }