{ "openapi": "3.0.1", "info": { "title": "Linkedin Scraper", "description": "Find the right jobs faster. Tired of LinkedIn’s slow UI and irrelevant listings? Our LinkedIn Job Scraper filters jobs using PUBLIC and PRIVATE scraping, unlocking premium insights and refining results by keywords, post date, and location—so you focus on the best opportunities, not the noise.", "version": "0.0", "x-build-id": "K5sRnZdbfSTvoTUdf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api_massta~linkedin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api_massta-linkedin-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/api_massta~linkedin-scraper/runs": { "post": { "operationId": "runs-sync-api_massta-linkedin-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/api_massta~linkedin-scraper/run-sync": { "post": { "operationId": "run-sync-api_massta-linkedin-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": [ "filter" ], "properties": { "filter": { "title": "Search keywords", "type": "string", "description": "The job search query, e.g. 'python developer', 'product manager', 'data scientist'. This is the main term LinkedIn matches against job titles and descriptions.", "default": "Developer" }, "location": { "title": "Location", "type": "string", "description": "City, region, or country to search in, e.g. 'United States', 'London', 'Remote'. Leave as a country for the broadest results.", "default": "United States" }, "posted_date": { "title": "Date posted", "enum": [ "any_time", "past_24_hrs", "past_week", "past_month" ], "type": "string", "description": "Only return jobs posted within this window. Use 'past_24_hrs' or 'past_week' for the freshest listings.", "default": "any_time" }, "order_by": { "title": "Sort order", "enum": [ "posted_date", "relevance" ], "type": "string", "description": "Sort results by most recent ('posted_date') or by LinkedIn relevance ('relevance').", "default": "posted_date" }, "limit": { "title": "Max jobs", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of jobs to return. Higher values take longer and cost more under pay-per-event.", "default": 25 }, "start": { "title": "Start page", "minimum": 0, "maximum": 20, "type": "integer", "description": "Page offset to start from (25 jobs per page). Use it to skip already-seen results and page deeper.", "default": 0 }, "include_company": { "title": "Include company details", "type": "boolean", "description": "Also fetch each company's profile (website, size, etc.). Slower, and billed as a separate 'company-enrichment' event per unique company.", "default": false }, "cookies": { "title": "LinkedIn cookies (optional)", "type": "array", "description": "Optional. Paste your LinkedIn session cookies (JSON export) ONLY to access login-gated jobs and richer fields. Leave empty for public scraping — no login needed.", "default": [] }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for requests. Recommended for larger or authenticated runs." }, "timeout": { "title": "Timeout", "minimum": 300, "maximum": 1000, "type": "integer", "description": "Seconds before the run gives up, to avoid getting stuck.", "default": 300 } } }, "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 } } } } } } } } } }