{ "openapi": "3.0.1", "info": { "title": "LinkedIn Recruiter Scraper 🔎 Find Recruiters & Hiring Managers", "description": "Find recruiters, hiring managers, and talent acquisition specialists from public LinkedIn profiles by keyword, industry, and location 🚀 Extract recruiter names, companies, locations, hiring niches, and profile URLs with clean structured data- no LinkedIn login or cookies required.", "version": "0.0", "x-build-id": "iv04sQ5J8ZefRbPdM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apt_marble~linkedIn-recruiter-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apt_marble-linkedIn-recruiter-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/apt_marble~linkedIn-recruiter-scraper/runs": { "post": { "operationId": "runs-sync-apt_marble-linkedIn-recruiter-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/apt_marble~linkedIn-recruiter-scraper/run-sync": { "post": { "operationId": "run-sync-apt_marble-linkedIn-recruiter-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": [ "recruiterTitles" ], "properties": { "recruiterTitles": { "title": "Recruiter Titles", "type": "array", "description": "Recruiter-related titles to search for. Common picks: Recruiter, Technical Recruiter, Talent Acquisition, Talent Acquisition Manager, HR Recruiter, Hiring Manager, Staffing Specialist, Recruiting Lead, Head of Recruitment, Recruitment Consultant. Each title runs its own search and the results are merged.", "default": [ "Recruiter", "Technical Recruiter", "Talent Acquisition" ], "items": { "type": "string" } }, "keywords": { "title": "Industry / Tech Keywords", "type": "array", "description": "Industry tags (`SaaS`, `Healthcare`, `Fintech`, `Cybersecurity`, `E-commerce`) or technologies (`React`, `Python`, `AI`, `Go`, `Kubernetes`). Used to find recruiters who specialize in those niches. Leave empty to skip keyword filtering.", "default": [], "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "One search runs per location. Common names work directly (`United States`, `United Kingdom`, `India`, `San Francisco Bay Area`, `New York`, `London area via United Kingdom`, `Bengaluru`, `Hyderabad`, `Delhi`), and a numeric LinkedIn geo id targets any other region (find it in the URL of a LinkedIn people search filtered by that location). A name the actor does not recognize joins the search text instead. Leave empty to search the United States.", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Maximum Profiles", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stop after collecting this many unique recruiter profiles (1-500). LinkedIn itself caps any single search at roughly 1000 results, so for bigger pulls run several narrower searches (more titles or locations) and merge the exports.", "default": 100 }, "language": { "title": "Search Language", "type": "string", "description": "Two-letter language hint for the search pages (`en`, `fr`, `de`, `es`, `pt`, ...).", "default": "en" }, "deduplicateResults": { "title": "Deduplicate Results", "type": "boolean", "description": "Drop profiles already delivered by an earlier search in the same run (the same recruiter can match several titles).", "default": true } } }, "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 } } } } } } } } } }