{ "openapi": "3.0.1", "info": { "title": "Jobs Search API — LinkedIn, Dice & Remote Jobs", "description": "Search jobs on LinkedIn, Dice and six remote job boards (Remote OK, We Work Remotely, Himalayas, Jobicy, Working Nomads, Arbeitnow) in one call. One deduplicated row per job: title, company, location, link, date, description snippet, salary when published. CSV, JSON, Excel.", "version": "0.1", "x-build-id": "2JUf9GsIvxBxMZZUE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/glasswing~jobs-search-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-glasswing-jobs-search-api", "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/glasswing~jobs-search-api/runs": { "post": { "operationId": "runs-sync-glasswing-jobs-search-api", "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/glasswing~jobs-search-api/run-sync": { "post": { "operationId": "run-sync-glasswing-jobs-search-api", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "Job titles or skills to search for, one per line (up to 5), e.g. python developer, nurse, data analyst. Every line is searched on its own and the results are merged.", "default": [ "python developer" ], "items": { "type": "string" } }, "location": { "title": "Location (city or region)", "type": "string", "description": "Optional city, state or region, e.g. Berlin, Austin TX, London. Used by LinkedIn and Dice. Leave empty to search the whole country or worldwide." }, "country": { "title": "Country", "type": "string", "description": "Optional country name or two-letter code, e.g. US, Germany, GB. Dice lists US jobs only and is skipped for other countries. The remote boards keep jobs open to applicants in this country plus jobs open worldwide. Leave empty for all countries." }, "sources": { "title": "Sources", "type": "array", "description": "Routes to search. Leave empty for all: LinkedIn, Dice and the six remote boards (Remotive is opt-in because it asks API users to call it at most 4 times a day).", "items": { "type": "string", "enum": [ "linkedin", "dice", "remoteok", "weworkremotely", "himalayas", "jobicy", "workingnomads", "arbeitnow", "remotive" ], "enumTitles": [ "LinkedIn", "Dice (US jobs)", "Remote OK", "We Work Remotely", "Himalayas", "Jobicy", "Working Nomads", "Arbeitnow (remote jobs only)", "Remotive (max 4 runs a day)" ] } }, "postedWithinDays": { "title": "Posted within the last N days", "minimum": 1, "type": "integer", "description": "Keep only jobs posted in the last N days. Jobs from a route that does not publish a date are kept. Leave empty for no limit." }, "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many unique jobs. Each saved job (status `ok`) is one billable result. Routes are interleaved, so a small number still shows every route.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy (datacenter, included in the price) is used for LinkedIn so it does not throttle the run. Residential proxies are not needed; a proxy group picked here is ignored. Your own proxy URLs are used as given.", "default": { "useApifyProxy": true } }, "startUrls": { "title": "Search page URLs (optional)", "uniqueItems": true, "type": "array", "description": "Optional LinkedIn or Dice job-search page URLs. Only the search words (keywords / q) and the location in the URL are used; they are added to Keywords and Location. Other filters in the URL are ignored.", "default": [], "items": { "type": "string" } } } }, "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 } } } } } } } } } }