{ "openapi": "3.0.1", "info": { "title": "X / Twitter Lists Scraper — Members & Subscribers", "description": "Discover public X / Twitter Lists an account owns, follows, or belongs to. Export List details, owners, members, and subscribers from usernames, user IDs, List IDs, or URLs. Build audience and lead datasets with automatic pagination—no X login, cookies, or API key required.", "version": "0.1", "x-build-id": "LeXX16borE8p1ufg2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arjun_code~x-twitter-lists-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arjun_code-x-twitter-lists-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/arjun_code~x-twitter-lists-scraper/runs": { "post": { "operationId": "runs-sync-arjun_code-x-twitter-lists-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/arjun_code~x-twitter-lists-scraper/run-sync": { "post": { "operationId": "run-sync-arjun_code-x-twitter-lists-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": [ "operation", "accountListType", "maxListsPerAccount", "maxUsersPerList" ], "properties": { "operation": { "title": "Data to collect", "enum": [ "account_lists", "memberships", "members", "subscribers" ], "type": "string", "description": "Choose one result type. The first two options use account inputs. The last two options use List IDs or URLs.", "default": "account_lists" }, "accountListType": { "title": "Owned or followed Lists", "enum": [ "all", "owned", "subscribed" ], "type": "string", "description": "Only used with Lists owned or followed by accounts. Choose whether to collect Lists created by the account, Lists the account follows, or both. The result limit applies separately to each type when Both is selected.", "default": "all" }, "screenNames": { "title": "Accounts — usernames or profile URLs", "maxItems": 50, "type": "array", "description": "Use for Lists owned or followed by accounts and Lists containing accounts. Enter one username, @handle, or profile URL per line, for example VitalikButerin, @VitalikButerin, or https://x.com/VitalikButerin. Up to 50 unique account inputs are accepted across both account fields combined.", "items": { "type": "string", "minLength": 1 } }, "userIds": { "title": "Accounts — user IDs", "maxItems": 50, "type": "array", "description": "Use for Lists owned or followed by accounts and Lists containing accounts. Enter one numeric X / Twitter user ID per line, for example 295218901. Up to 50 unique account inputs are accepted across both account fields combined.", "items": { "type": "string", "minLength": 1 }, "default": [] }, "listIds": { "title": "Lists — IDs or URLs", "maxItems": 50, "type": "array", "description": "Use for Members of Lists and Subscribers of Lists. Enter one numeric List ID or full List URL per line, for example 1455191294725312517 or https://x.com/i/lists/1455191294725312517. Up to 50 unique Lists are accepted per run.", "items": { "type": "string", "minLength": 1 }, "default": [] }, "maxListsPerAccount": { "title": "Maximum Lists per account", "minimum": 0, "type": "integer", "description": "Used for the first two data options. Sets the maximum number of Lists returned for each account. Enter 0 to collect every visible List. When both owned and followed Lists are selected, this limit applies separately to each type.", "default": 100 }, "maxUsersPerList": { "title": "Maximum members or subscribers per List", "minimum": 0, "type": "integer", "description": "Used for Members of Lists and Subscribers of Lists. Sets the maximum number of users returned from each List. Enter 0 to collect every result X makes available.", "default": 100 } } }, "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 } } } } } } } } } }