{ "openapi": "3.0.1", "info": { "title": "X (Twitter) People Search Scraper – Find X Users", "description": "Search X (Twitter) users by keyword, filter profiles by followers, verification, visibility, website, posts, location, or creation date, and export structured data.", "version": "0.2", "x-build-id": "ifHaYNtmXmRfmSfRj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arjun_code~x-twitter-people-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arjun_code-x-twitter-people-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-people-search-scraper/runs": { "post": { "operationId": "runs-sync-arjun_code-x-twitter-people-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-people-search-scraper/run-sync": { "post": { "operationId": "run-sync-arjun_code-x-twitter-people-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", "maxUsersPerQuery" ], "properties": { "searchQueries": { "title": "People search queries", "minItems": 1, "maxItems": 25, "type": "array", "description": "Enter one keyword or phrase per line. Each query is sent independently to X People search, and results follow X's own ranking. You can search for a name, handle, organization, profession, topic, niche, or location phrase. Operators intended for post search are not supported. Up to 25 query entries are accepted per run and processed sequentially; exact duplicates are queried only once.", "items": { "type": "string", "minLength": 1 } }, "maxUsersPerQuery": { "title": "Maximum matching profiles per query", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Enter a value from 1 to 1,000. This is the maximum number of profiles that pass all selected filters and are saved for each query. The Actor follows X result pages until it reaches this limit or X has no more results. The limit applies separately to each query.", "default": 20 }, "minFollowers": { "title": "Minimum followers", "minimum": 0, "type": "integer", "description": "Only save accounts with at least this many followers. Keep 0 to allow accounts with any follower count.", "default": 0 }, "maxFollowers": { "title": "Maximum followers", "minimum": 0, "type": "integer", "description": "Only save accounts with no more than this many followers. Leave empty to apply no maximum follower limit." }, "minTweets": { "title": "Minimum posts", "minimum": 0, "type": "integer", "description": "Only save accounts with at least this many total posts. Keep 0 to disable this filter. This measures lifetime posting volume, not recent activity.", "default": 0 }, "verification": { "title": "Verification or badge type", "enum": [ "any", "any_verified", "blue_verified", "business", "government", "unverified" ], "type": "string", "description": "Choose which X verification or badge signals to keep. Blue, Business, and Government badges are separate signals and may overlap. Any verified or badged account includes all three types.", "default": "any" }, "visibility": { "title": "Account visibility", "enum": [ "any", "public", "protected" ], "type": "string", "description": "Keep accounts with any visibility, public accounts only, or protected accounts only. Protected accounts may restrict access to their posts.", "default": "any" }, "requireWebsite": { "title": "Require a website", "type": "boolean", "description": "Only save accounts that include a website URL in their X profile. Useful for finding organizations, businesses, researchers, creators, and potential leads.", "default": false }, "locationKeywords": { "title": "Profile location contains", "type": "array", "description": "Enter one location phrase per line. An account is kept when its self-reported profile location contains at least one phrase, without regard to letter case. For example, San Francisco matches San Francisco, CA and San Francisco Bay Area, but does not automatically match the abbreviation SF.", "items": { "type": "string", "minLength": 1 }, "default": [] }, "createdAfter": { "title": "Created on or after", "type": "string", "description": "Only save accounts created on or after this date. Leave empty to apply no earliest creation date. Dates are evaluated in UTC." }, "createdBefore": { "title": "Created on or before", "type": "string", "description": "Only save accounts created on or before this date. Leave empty to apply no latest creation date. The entire selected day is included and dates are evaluated in UTC." } } }, "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 } } } } } } } } } }