{ "openapi": "3.0.1", "info": { "title": "Twitter X Reply Scraper By Verified & Engagement Filter", "description": "๐Ÿ’ฌ Twitter X Reply Scraper captures public replies from X/Twitter threads โ€” usernames, timestamps, text, links, IDs & engagement. โšก Export CSV/JSON, filter by keywords, track sentiment & monitor campaigns. ๐Ÿš€ Perfect for social listening, customer support, and research.", "version": "0.1", "x-build-id": "2bJ26QYdGI04U81Bb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~twitter-x-reply-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-twitter-x-reply-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/api-empire~twitter-x-reply-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-twitter-x-reply-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/api-empire~twitter-x-reply-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-twitter-x-reply-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": [ "startUrls" ], "properties": { "startUrls": { "title": "๐Ÿ”— Start URLs โ€” where to look on X", "type": "array", "description": "๐Ÿ“‹ Add one or more X search page links (the same URLs you get when you search on x.com). Each link defines what topic or keywords you want to follow. You can add as many as you need โ€” great for tracking several topics in one run! ๐ŸŒโœ…", "items": { "type": "string" } }, "maxSearchResults": { "title": "๐Ÿ“Š Maximum posts to collect", "minimum": 1, "maximum": 5000, "type": "integer", "description": "๐ŸŽฏ Choose how many posts you want from each search link โ€” higher numbers give you a broader snapshot; lower numbers finish faster. Pick what fits your project! โšก๐Ÿ“ˆ", "default": 10 }, "maxReplies": { "title": "๐Ÿ’ฌ Maximum replies per post", "minimum": 1, "maximum": 500, "type": "integer", "description": "๐Ÿ’ก For each post found, decide how many replies to keep in your results โ€” counted AFTER the filters below are applied. Ideal when you want a taste of the conversation or a deeper thread. ๐Ÿ™Œ๐Ÿงต", "default": 5 }, "verifiedRepliersOnly": { "title": "โœ… Verified repliers only", "type": "boolean", "description": "Keep only replies written by a verified account (blue check / verified organization). Unverified replies are dropped before your reply limit is applied. Example: 40 replies fetched, 6 verified โ†’ up to 6 kept. Default is off.", "default": false }, "minReplyLikes": { "title": "๐Ÿ‘ Minimum reply likes", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Drop any reply with fewer likes (favorites) than this number. Example: minReplyLikes=5 keeps only replies with 5 or more likes. Set to 0 to keep replies with any like count. Default is 0.", "default": 0 }, "replyKeywords": { "title": "๐Ÿ” Include replies with keywords", "type": "array", "description": "Keep only replies whose text contains at least one of these words or phrases (case-insensitive substring match). Example: [\"pitch\", \"available\"] keeps replies mentioning either. Leave empty to keep replies regardless of wording.", "default": [], "items": { "type": "string" } }, "excludeKeywords": { "title": "๐Ÿšซ Exclude replies with keywords", "type": "array", "description": "Drop any reply whose text contains one of these words or phrases (case-insensitive substring match). Example: [\"spam\", \"giveaway\"] removes replies mentioning either. Leave empty to disable. Applied after the include filter.", "default": [], "items": { "type": "string" } }, "authToken": { "title": "๐Ÿ” Session โ€” auth token", "type": "string", "description": "๐Ÿ”‘ Your X account session token (or set the AUTH_TOKEN environment variable in Apify). This lets the actor use your logged-in session. Keep it private โ€” never share it publicly! ๐Ÿคซ๐Ÿ”’" }, "ct0": { "title": "๐Ÿ›ก๏ธ Session โ€” security (ct0)", "type": "string", "description": "โœจ The companion security value for your X session (or use the CT0 env var). It works together with your auth token so everything stays in sync โ€” like a key and a lock! ๐Ÿ”๐Ÿ’™" }, "proxyConfiguration": { "title": "๐ŸŒ Connection & privacy (proxy)", "type": "object", "description": "๐ŸŒ Optional **Apify Proxy** settings for smoother runs in the cloud. Turn it on if you prefer routing traffic through Apifyโ€™s network โ€” handy for stable jobs and privacy-friendly setups. Off by default; enable when it suits you! โ˜๏ธโœ…" } } }, "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 } } }, "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 } } } } } } } } } }