{ "openapi": "3.0.1", "info": { "title": "LinkedIn People Scraper", "description": "Advanced LinkedIn People Scraper for high-quality lead generation. Extract verified profile data including names, job titles, companies, locations, emails, and phone numbers using secure authenticated sessions. Perfect for sales prospecting, recruitment, and B2B outreach at scale.", "version": "1.0", "x-build-id": "Vd8P2cPf5i8iRkVfW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/angelusm~linkedin-people-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-angelusm-linkedin-people-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/angelusm~linkedin-people-scraper/runs": { "post": { "operationId": "runs-sync-angelusm-linkedin-people-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/angelusm~linkedin-people-scraper/run-sync": { "post": { "operationId": "run-sync-angelusm-linkedin-people-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": [ "linkedInSessionCookie", "searchQuery", "scraperMode" ], "properties": { "linkedInSessionCookie": { "title": "LinkedIn Session Cookie (li_at)", "type": "string", "description": "Your LinkedIn session cookie value. Log in to LinkedIn in your browser, open DevTools → Application → Cookies → find 'li_at' and paste its value here. This is required for the actor to access profile data. Treated as a secret — never logged or stored." }, "scraperMode": { "title": "Scraper Mode", "enum": [ "fullProfile", "fullProfileWithEmail" ], "type": "string", "description": "Full Profile scrapes authenticated profile data. Full Profile with Email also extracts emails from the Contact Info section and from external websites linked on the profile.", "default": "fullProfile" }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Fuzzy query to search LinkedIn people. Examples: 'Founder', 'Marketing Manager', 'John Doe', 'VP Sales fintech'." }, "maxProfiles": { "title": "Number of Profiles to Scrape", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum total profiles to collect across all pages. Each search results page returns approximately 10 profiles when authenticated.", "default": 50 }, "startPage": { "title": "Start Page", "minimum": 1, "type": "integer", "description": "Which page number to begin scraping from. Use this to resume an interrupted run or skip initial results. Page 1 is the default.", "default": 1 }, "numberOfPages": { "title": "Number of Pages to Scrape", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many consecutive pages of search results to scrape. Each page has ~10 profiles when authenticated.", "default": 5 }, "locationFilter": { "title": "Locations", "type": "array", "description": "Filter profiles by geographic location. Enter city, region, or country names. Examples: 'United States', 'London, UK', 'Nairobi, Kenya', 'California'.", "items": { "type": "string" } }, "currentCompanyFilter": { "title": "Current Company", "type": "array", "description": "Filter by current employer name. Example: 'Google', 'Accenture'.", "items": { "type": "string" } }, "pastCompanyFilter": { "title": "Past Company", "type": "array", "description": "Filter by names of companies the person has previously worked at.", "items": { "type": "string" } }, "schoolFilter": { "title": "School / University", "type": "array", "description": "Filter by educational institution. Example: 'University of Nairobi', 'Harvard', 'MIT'.", "items": { "type": "string" } }, "currentJobTitleFilter": { "title": "Current Job Title", "type": "array", "description": "Filter by current job title keywords. Example: 'CEO', 'Software Engineer', 'Head of Marketing'.", "items": { "type": "string" } }, "pastJobTitleFilter": { "title": "Past Job Title", "type": "array", "description": "Filter by previous job titles the person has held.", "items": { "type": "string" } }, "yearsOfExperienceFilter": { "title": "Years of Experience", "enum": [ "any", "1", "2", "3", "4", "5" ], "type": "string", "description": "Filter by total years of professional experience.", "default": "any" }, "yearsAtCurrentCompanyFilter": { "title": "Years at Current Company", "enum": [ "any", "1", "2", "3", "4", "5" ], "type": "string", "description": "Filter by tenure at the person's current employer.", "default": "any" }, "seniorityFilter": { "title": "Seniority Level", "type": "array", "description": "Filter by seniority level — enter one or more of these exact values: Internship, Entry level, Associate, Mid-Senior level, Director, Executive, Owner, Partner, CXO, Staff.", "items": { "type": "string" } }, "functionFilter": { "title": "Job Function", "type": "array", "description": "Filter by job function or department. Example: 'Engineering', 'Sales', 'Marketing', 'Finance'.", "items": { "type": "string" } }, "firstNamesFilter": { "title": "First Names", "type": "array", "description": "Filter by first name. Useful for finding specific individuals. Example: 'John', 'Sarah'.", "items": { "type": "string" } }, "lastNamesFilter": { "title": "Last Names", "type": "array", "description": "Filter by surname.", "items": { "type": "string" } }, "profileLanguagesFilter": { "title": "Profile Languages", "type": "array", "description": "Filter by the language the LinkedIn profile is written in — enter language codes: en, fr, de, es, pt, ar, zh, ja, hi, sw, it, ru, nl, ko, tr.", "items": { "type": "string" } }, "companyHeadcountFilter": { "title": "Company Headcount", "type": "array", "description": "Filter by company size — enter one or more letter codes: A (1 person), B (2-10), C (11-50), D (51-200), E (201-500), F (501-1000), G (1001-5000), H (5001-10000), I (10001+).", "items": { "type": "string" } }, "companyHQLocationsFilter": { "title": "Company Headquarter Locations", "type": "array", "description": "Filter by the HQ country or region of the person's current company. Example: 'United States', 'Germany'.", "items": { "type": "string" } }, "websiteCrawlDepth": { "title": "Website Crawl Depth (Email Mode)", "minimum": 1, "maximum": 3, "type": "integer", "description": "Only used in 'Full Profile with Email' mode. How many pages deep to crawl each linked external website when searching for emails. 1 = homepage only, 2 = homepage + contact/about pages. Maximum recommended: 3.", "default": 2 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are strongly recommended for LinkedIn to avoid detection and blocks." } } }, "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 } } } } } } } } } }