{ "openapi": "3.0.1", "info": { "title": "Linkedin Mass People Profile Finder By Name, Company & City", "description": "LinkedIn Mass People Profile Finder by Name, Company & City discovers public LinkedIn profiles in bulk using names, companies, and city filters. Extract names, job titles, companies, locations, profile URLs, and more for B2B lead generation, recruitment, sales prospecting, and market research.", "version": "0.1", "x-build-id": "gHZeIbUCO514f1BF2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~linkedin-mass-people-profile-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-linkedin-mass-people-profile-finder", "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/scraper-engine~linkedin-mass-people-profile-finder/runs": { "post": { "operationId": "runs-sync-scraper-engine-linkedin-mass-people-profile-finder", "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/scraper-engine~linkedin-mass-people-profile-finder/run-sync": { "post": { "operationId": "run-sync-scraper-engine-linkedin-mass-people-profile-finder", "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": [ "queries" ], "properties": { "queries": { "title": "🧾 Search Queries (one per line)", "minItems": 1, "type": "array", "description": "List of free-text queries. Each line becomes one query β€” e.g. a name + company + title. Tip: wrap exact terms in quotes for tighter matches (e.g. \"Michael Dell\" \"Dell Technologies\" CEO).", "items": { "type": "string" } }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Override the automatic proxy ladder. Leave as default (no proxy) unless you have a specific reason β€” the actor will handle blocks for you.", "default": { "useApifyProxy": false } }, "people": { "title": "πŸ‘€ People (one row per person: name, company, title, city)", "type": "array", "description": "🧾 Paste your list as columns instead of writing search strings. Each entry is one person and becomes one result row β€” fill in whichever of first name, last name, company, job title and city you have, and the actor builds the search for you. A row with a company or a city in it finds different people than the same name on its own, which is the whole point of typing them separately. Leave this empty to use the query box above exactly as before.", "default": [] }, "queryLadder": { "title": "πŸ” Try again with fewer details when nothing comes back", "type": "boolean", "description": "🎯 When a person's full-column search returns nothing, search again in the same run with one detail removed, then another, down to the bare name β€” and stop the moment a profile comes back. This only ever runs after an empty result, so a clean list costs exactly what it costs today. Every attempt is written into the output, so you can see whether a row was found on the full question or only on the loose one.", "default": true }, "ladderOrder": { "title": "πŸͺœ Which details to drop first", "type": "array", "description": "🧩 The order details are dropped when a search comes back empty. The default drops the job title first (it is the noisiest thing to search on), then the city, and keeps the employer longest β€” searching with an employer changed the result set the most in testing. A recruiter usually wants the employer kept last; a territory-based sales rep usually wants the city kept last. First and last name are never dropped β€” the bare name is always the final attempt.", "items": { "type": "string", "enum": [ "jobTitle", "location", "company" ] }, "default": [ "jobTitle", "location", "company" ] }, "searchRegion": { "title": "🌍 Search Region", "enum": [ "us-en", "uk-en", "ca-en", "au-en", "in-en", "de-de", "fr-fr", "es-es", "wt-wt" ], "type": "string", "description": "πŸ—ΊοΈ Which regional edition of the search index to use. The default us-en is exactly what this actor uses today, so leaving it alone changes nothing. Switch it if your list is not American β€” a German list searched against the US-English index is searching the wrong index.", "default": "us-en" } } }, "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 } } } } } } } } } }