{ "openapi": "3.0.1", "info": { "title": "Twitter X Reply Scraper With Replier Contact Leads", "description": "Twitter/X Reply Scraper extracts replies and replier details, including usernames, profile data, reply text, timestamps, engagement metrics, and publicly available contact leads. Ideal for audience research, lead generation, engagement analysis, and social media intelligence.", "version": "0.1", "x-build-id": "9X0dZlfZg0wPPu7Fl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~twitter-x-reply-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-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/simpleapi~twitter-x-reply-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-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/simpleapi~twitter-x-reply-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-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. Reply threads like #journorequest or #hiring are great lead sources. Add as many as you need! ๐ŸŒโœ…", "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, how many replies (leads) to keep โ€” counted AFTER the contacts-only filter below. Example: 40 replies fetched, 8 with a contact, maxReplies=5 โ†’ 5 kept. Default is 5. ๐Ÿ™Œ๐Ÿงต", "default": 5 }, "extractReplierContacts": { "title": "๐Ÿงฉ Extract replier contact leads", "type": "boolean", "description": "Harvest each reply author's bio, location, website, email and phone (only when literally present in the profile or reply text โ€” never guessed), plus follower/following/tweet counts. Turn off for the plain post+reply output. Default is on.", "default": true }, "contactsOnly": { "title": "๐Ÿ“‡ Contacts only (leads with email / website / phone)", "type": "boolean", "description": "Keep only replies whose author has at least one contact detail (email, website or phone). Replies with no contact are dropped before the reply limit is applied, giving you a clean lead list. Example: 40 replies, 8 with a contact โ†’ up to maxReplies of those 8. Default is off.", "default": false }, "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 to read replies. 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 } } } } } } } } } }