{ "openapi": "3.0.1", "info": { "title": "LinkedIn Profile Scraper", "description": "LinkedIn Profile Scraper — Extract LinkedIn profile data including names, job titles, work experience, education, skills, locations, company details, profile URLs, and professional summaries. Useful for lead generation, recruitment, prospecting, market research, and professional networking.", "version": "1.0", "x-build-id": "kHxDlVN7shptTGYrg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/socialdataapi~linkedin-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-socialdataapi-linkedin-profile-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/socialdataapi~linkedin-profile-scraper/runs": { "post": { "operationId": "runs-sync-socialdataapi-linkedin-profile-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/socialdataapi~linkedin-profile-scraper/run-sync": { "post": { "operationId": "run-sync-socialdataapi-linkedin-profile-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", "properties": { "urls": { "title": "🔗 LinkedIn profile URLs", "type": "array", "description": "Public profile links, one per line, e.g. https://www.linkedin.com/in/timbakke/. Both name links (/in/handle) and ID links (/in/ACoAA...) work; duplicates are scraped once. Each profile gives one row. Free plan: up to 20 profiles per run (all profile URLs together) and 200 per month; paid plans have no limit.", "items": { "type": "string" } }, "extractSimilarProfiles": { "title": "✅ People also viewed", "type": "boolean", "description": "Include the \"People also viewed\" profiles shown on the page (link, name, location, photo). Turn off to leave similarProfiles empty.", "default": true }, "extractProjects": { "title": "✅ Projects", "type": "boolean", "description": "Include the Projects section (name, link, dates, description, contributors). Turn off to leave projects empty.", "default": true }, "extractRecommendations": { "title": "✅ Recommendations", "type": "boolean", "description": "Include the written recommendations shown on the profile (name, link, photo, text). Turn off to leave recommendations empty.", "default": true }, "customFetcherUrlTemplate": { "title": "🔑 Your scraping API URL template", "type": "string", "description": "Optional. The full request URL of a scraping API you already use, with the literal placeholder {url} where the profile URL goes, e.g. https://api.example.com/?api_key=YOUR_KEY&url={url}. The profile URL is URL-encoded and requested with GET. Leave empty to skip. Rows from it have source \"custom_fetcher\"." }, "enableWaybackFallback": { "title": "✅ Archived copy when blocked", "type": "boolean", "description": "Use the latest copy of the profile saved in the public web archive. An archived copy can be older than the live profile; rows from it have source \"wayback\".", "default": true }, "enableWaybackSaveFallback": { "title": "✅ Fresh archived copy when blocked", "type": "boolean", "description": "When no archived copy exists, ask the public web archive to save the profile now and use that copy. Slow (up to 90 seconds per profile) and rate-limited; turn off for large runs. Rows from it have source \"wayback_spn\".", "default": true }, "maxRetries": { "title": "🔁 Retry rounds per page", "minimum": 1, "maximum": 15, "type": "integer", "description": "Quick retry rounds for a blocked page, each on fresh connections and with a growing number of parallel attempts. After them come 3 more rounds after pauses of 5, 15 and 30 seconds. Default 5.", "default": 5 }, "requestTimeoutSecs": { "title": "⏳ Request timeout (seconds)", "minimum": 5, "maximum": 180, "type": "integer", "description": "How long one request may take before it counts as failed and is retried. Default 30.", "default": 30 }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Apify residential proxy is used by default, with a fresh session for every request. With the proxy turned off, or with a non-residential proxy, the run switches to Apify's residential proxy as soon as LinkedIn blocks it (when your account has it).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }