{ "openapi": "3.0.1", "info": { "title": "LinkedIn Profile Search: Candidates by Title and City", "description": "Build candidate and prospect lists from public LinkedIn profiles by job title, location, company, school or industry. Short mode returns name, headline, title, company, location and profile URL. No login.", "version": "0.2", "x-build-id": "L7WkT0o9XpESSYPog" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/transparent_meteorite~linkedin-profile-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-transparent_meteorite-linkedin-profile-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/transparent_meteorite~linkedin-profile-search/runs": { "post": { "operationId": "runs-sync-transparent_meteorite-linkedin-profile-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/transparent_meteorite~linkedin-profile-search/run-sync": { "post": { "operationId": "run-sync-transparent_meteorite-linkedin-profile-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": { "searchQuery": { "title": "Search query (free text)", "type": "string", "description": "Any words to match on the profile, e.g. \"Salesforce admin\" or \"founder fintech\". Combined with the filters below." }, "currentJobTitles": { "title": "Job titles", "type": "array", "description": "Job titles to search for. Each title is searched separately (and combined with each location / company).", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Cities, metro areas, states or countries, e.g. \"Detroit\", \"Austin, Texas\", \"Germany\".", "items": { "type": "string" } }, "currentCompanies": { "title": "Companies", "type": "array", "description": "Company names, e.g. \"Ford Motor Company\". Matches people who list that company.", "items": { "type": "string" } }, "schools": { "title": "Schools", "type": "array", "description": "Schools or universities, e.g. \"University of Michigan\".", "items": { "type": "string" } }, "industries": { "title": "Industries / keywords", "type": "array", "description": "Industry words or skills, e.g. \"SaaS\", \"healthcare\", \"PPC\".", "items": { "type": "string" } }, "firstNames": { "title": "First names", "type": "array", "description": "Find people by first name (combine with last names to look up a specific person).", "items": { "type": "string" } }, "lastNames": { "title": "Last names", "type": "array", "description": "Find people by last name.", "items": { "type": "string" } }, "fillMissingDetails": { "title": "Fill missing location and follower counts", "type": "boolean", "description": "When the fast search route returns profiles without location or follower counts, re-read that page through Google directly (up to 40 s per page) to fill them in.", "default": true }, "profileScraperMode": { "title": "Profile detail", "enum": [ "short", "full" ], "type": "string", "description": "Full reads each public profile page. If LinkedIn refuses one, that row comes back with the search data and is charged the short price.", "default": "short" }, "maxItems": { "title": "Max profiles", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on profiles (and cost) for the whole run.", "default": 50 }, "maxSearchPagesPerQuery": { "title": "Google pages per search", "minimum": 1, "maximum": 8, "type": "integer", "description": "Each search is asked up to this many times with different recency and country settings to find more people (about 10 profiles per page). The actor stops early when pages stop finding new people.", "default": 8 }, "onlyNew": { "title": "Monitor mode: only new profiles", "type": "boolean", "description": "Remembers profiles already delivered (named key-value store) and returns only new ones next run. Already-seen profiles are not charged. Schedule it weekly.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Use a different name per saved search.", "default": "linkedin-profile-search-monitor" } } }, "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 } } } } } } } } } }