{ "openapi": "3.0.1", "info": { "title": "X (Twitter) Users & Profiles Search", "description": "Search X (Twitter) profiles by bio keywords, follower & post counts, location, verification, account age, and the website domain in their bio. Find everyone at a company, niche creators, or active accounts. Export clean profile lists to CSV, Clay, or your CRM.", "version": "0.0", "x-build-id": "b65F5eJj7ZwRHgko0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/industrial_intensity~x-twitter-users-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-industrial_intensity-x-twitter-users-search", "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/industrial_intensity~x-twitter-users-search/runs": { "post": { "operationId": "runs-sync-industrial_intensity-x-twitter-users-search", "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/industrial_intensity~x-twitter-users-search/run-sync": { "post": { "operationId": "run-sync-industrial_intensity-x-twitter-users-search", "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", "properties": { "bioAnyOf": { "title": "Bio contains ANY of", "type": "array", "description": "Match users whose bio contains AT LEAST ONE of these words. Example: ['founder', 'ceo'] → people who say founder OR ceo.", "items": { "type": "string" } }, "bioAllOf": { "title": "Bio contains ALL of", "type": "array", "description": "Match users whose bio contains EVERY one of these words. Example: ['ai', 'founder'] → people who say BOTH ai AND founder.", "items": { "type": "string" } }, "bioNoneOf": { "title": "Bio contains NONE of", "type": "array", "description": "Skip users whose bio contains ANY of these words. Example: ['recruiter', 'agency'] → exclude recruiters and agencies.", "items": { "type": "string" } }, "bioPhrase": { "title": "Bio contains exact phrase", "type": "string", "description": "Match users whose bio contains this exact phrase. Example: 'head of product'." }, "bioQuery": { "title": "Bio query (advanced boolean)", "type": "string", "description": "Power-user boolean query against the bio. Supports AND, OR, NOT, parentheses, and \"quoted phrases\". Example: (founder OR ceo) AND ai NOT recruiter." }, "usernames": { "title": "Usernames (exact)", "type": "array", "description": "Restrict to these X usernames (without @).", "items": { "type": "string" } }, "excludeUsernames": { "title": "Exclude usernames", "type": "array", "description": "Skip these X usernames (without @).", "items": { "type": "string" } }, "usernamePrefix": { "title": "Username starts with", "type": "string", "description": "Match usernames starting with this prefix (min 3 chars, alphanumeric + underscore)." }, "minFollowers": { "title": "Min followers", "minimum": 0, "type": "integer", "description": "Only accounts with at least this many followers." }, "maxFollowers": { "title": "Max followers", "minimum": 0, "type": "integer", "description": "Only accounts with at most this many followers." }, "minFollowing": { "title": "Min following", "minimum": 0, "type": "integer", "description": "Only accounts following at least this many other accounts." }, "maxFollowing": { "title": "Max following", "minimum": 0, "type": "integer", "description": "Only accounts following at most this many other accounts." }, "minPosts": { "title": "Min posts (tweets)", "minimum": 0, "type": "integer", "description": "Minimum number of posts on the account." }, "maxPosts": { "title": "Max posts (tweets)", "minimum": 0, "type": "integer", "description": "Maximum number of posts on the account." }, "verifiedOnly": { "title": "Verified only", "type": "boolean", "description": "Only accounts with a verification badge (any type).", "default": false }, "hasLocation": { "title": "Must have a location set", "type": "boolean", "description": "Only profiles that have a non-empty location field.", "default": false }, "hasLink": { "title": "⭐ Must have a website link (premium)", "type": "boolean", "description": "PREMIUM ($0.20/profile, no free tier): only profiles that list a website/link.", "default": false }, "linkDomains": { "title": "⭐ Website domain is one of (premium)", "type": "array", "description": "PREMIUM ($0.20/profile, no free tier): only profiles whose website link is on one of these domains (bare host, e.g. github.com, substack.com). Find everyone at a company, or every creator on a platform.", "items": { "type": "string" } }, "excludeLinkDomains": { "title": "⭐ Exclude website domains (premium)", "type": "array", "description": "PREMIUM ($0.20/profile, no free tier): skip profiles whose website link is on one of these domains.", "items": { "type": "string" } }, "locations": { "title": "Locations (phrase match)", "type": "array", "description": "Match any of these location strings (phrase match), e.g. 'San Francisco', 'London'.", "items": { "type": "string" } }, "excludeLocations": { "title": "Exclude locations", "type": "array", "description": "Skip profiles whose location matches any of these strings (phrase match), e.g. 'India', 'Remote'.", "items": { "type": "string" } }, "createdAfter": { "title": "Account created after", "type": "string", "description": "ISO 8601 date, e.g. 2023-01-01T00:00:00Z." }, "createdBefore": { "title": "Account created before", "type": "string", "description": "ISO 8601 date, e.g. 2026-01-01T00:00:00Z." }, "activeWithin": { "title": "⭐ Last active within (premium)", "enum": [ "", "90", "180", "365" ], "type": "string", "description": "PREMIUM ($0.20/profile, no free tier): restrict to profiles seen active within this window — unique recency data nobody else has. Activity is refreshed periodically, so only coarse windows are offered (no exact dates). Leave as \"Any time\" to not filter on activity (and stay on standard pricing).", "default": "" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "followers_desc", "followers_asc", "following_desc", "following_asc", "posts_desc", "posts_asc", "createdAt_desc", "createdAt_asc", "lastActiveAt_desc", "lastActiveAt_asc" ], "type": "string", "description": "How to order results. \"Most recently active\" is premium ($0.20/profile) — it ranks by our unique recency signal.", "default": "relevance" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum profiles to return. Standard cost ≈ (maxResults − 25 free) × $0.07. Premium (website-domain) runs ≈ maxResults × $0.20 with no free tier. Hard cap 10,000.", "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 } } }, "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 } } } } } } } } } }