{ "openapi": "3.0.1", "info": { "title": "X (Twitter) List Search Scraper & Finder", "description": "Find public X (Twitter) Lists for any topic or niche. Export List names, descriptions, member and subscriber counts, creation dates, and creator profiles. Filter results to uncover relevant communities for audience research, influencer discovery, and lead generation - no login or API key required.", "version": "0.1", "x-build-id": "0c4amwBPFWShA7iCT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arjun_code~x-twitter-list-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arjun_code-x-twitter-list-search-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-list-search-scraper/runs": { "post": { "operationId": "runs-sync-arjun_code-x-twitter-list-search-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-list-search-scraper/run-sync": { "post": { "operationId": "run-sync-arjun_code-x-twitter-list-search-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": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search keywords (up to 25)", "minItems": 1, "maxItems": 25, "type": "array", "description": "Enter up to 25 topics or keywords, one per line, for example AI or venture capital. Each line is searched separately. Blank lines are ignored, repeated identical searches run only once, and results follow X's List search order.", "items": { "type": "string" } }, "maxListsPerQuery": { "title": "Lists per search (1–1,000)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of unique Lists to save for each keyword search. Enter a whole number from 1 to 1,000. Default: 100. For example, two searches with a limit of 100 can save up to 200 results. X may return fewer matches.", "default": 100 }, "ownerVerification": { "title": "Owner verification or badge", "enum": [ "any", "any_verified", "blue_verified", "business", "government", "unverified" ], "type": "string", "description": "Filter by verification signals on the account that created the List. Blue, Business, and Government badges are separate signals and may overlap. Any verified or badged owner includes all available signals.", "default": "any" }, "minMembers": { "title": "Minimum List members", "minimum": 0, "type": "integer", "description": "Only save Lists containing at least this many members. Keep 0 to allow any number of members.", "default": 0 }, "maxMembers": { "title": "Maximum List members (0 = no limit)", "minimum": 0, "type": "integer", "description": "Only save Lists containing no more than this many members. Keep 0 to apply no maximum.", "default": 0 }, "minSubscribers": { "title": "Minimum List subscribers", "minimum": 0, "type": "integer", "description": "Only save Lists followed by at least this many subscribers. Subscribers follow the List; they are different from its members. Keep 0 to disable this filter.", "default": 0 }, "onlyWithDescription": { "title": "Only Lists with a description", "type": "boolean", "description": "Enable this to exclude Lists whose description is empty.", "default": false }, "minOwnerFollowers": { "title": "Minimum owner followers", "minimum": 0, "type": "integer", "description": "Only save Lists created by accounts with at least this many followers. Keep 0 to disable this filter.", "default": 0 } } }, "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 } } } } } } } } } }