{ "openapi": "3.0.1", "info": { "title": "Jobs With Salary: Pay-Transparent Job Listings API", "description": "Search live job postings that publish a salary range, from the career pages of thousands of companies. Filter by pay, role, location, remote and freshness.", "version": "0.1", "x-build-id": "s5hvNbb604jOoG7ra" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/variegated_trifle~jobs-with-salary/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-variegated_trifle-jobs-with-salary", "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/variegated_trifle~jobs-with-salary/runs": { "post": { "operationId": "runs-sync-variegated_trifle-jobs-with-salary", "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/variegated_trifle~jobs-with-salary/run-sync": { "post": { "operationId": "run-sync-variegated_trifle-jobs-with-salary", "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": "Job title keywords", "type": "array", "description": "Match jobs whose title, department or team contains ANY of these words (e.g. backend, data scientist).", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude title keywords", "type": "array", "description": "Drop jobs whose title contains any of these (e.g. intern, manager).", "items": { "type": "string" } }, "minSalary": { "title": "Minimum yearly salary", "minimum": 0, "type": "integer", "description": "Keep jobs whose top of range, converted to a yearly figure, reaches this amount. Hourly, weekly and monthly pay is converted to yearly. Jobs with an unknown pay period are skipped when this is set. Amounts are in the job's own currency, so combine with Currency.", "default": 0 }, "maxSalary": { "title": "Maximum yearly salary", "minimum": 0, "type": "integer", "description": "Keep jobs whose bottom of range, converted to a yearly figure, is at or below this amount. 0 means no limit.", "default": 0 }, "currency": { "title": "Currency", "enum": [ "ANY", "USD", "EUR", "GBP", "CAD", "AUD", "CHF", "PLN", "SEK", "NOK", "DKK", "SGD", "INR", "BRL", "JPY" ], "type": "string", "description": "Only jobs paid in this currency. ANY keeps all currencies; no exchange-rate conversion is applied.", "default": "ANY" }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Only remote jobs (the posting says remote in its workplace type, title or location).", "default": false }, "locationContains": { "title": "Location contains", "type": "array", "description": "Match jobs with a location containing ANY of these texts (e.g. germany, london, new york).", "items": { "type": "string" } }, "companies": { "title": "Companies", "type": "array", "description": "Only these companies. Use the company name or its board slug (the part after the job-board domain).", "items": { "type": "string" } }, "employmentTypes": { "title": "Employment types", "type": "array", "description": "Match the posting's employment type exactly, case-insensitive (e.g. FullTime, Full-time, Contract). Not every posting states one.", "items": { "type": "string" } }, "ats": { "title": "Job board source", "type": "array", "description": "Restrict to postings from these job boards. Leave empty for all.", "items": { "type": "string", "enum": [ "greenhouse", "lever", "ashby" ] } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "type": "integer", "description": "Only jobs posted in the last N days. 0 means any age. When a posting has no posted date, the date we first saw it is used.", "default": 0 }, "firstSeenWithinHours": { "title": "Newly discovered within (hours)", "minimum": 0, "type": "integer", "description": "Only jobs we first saw in the last N hours. Use this on a schedule to get just the new jobs since your last run.", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "newest", "salaryDesc", "salaryAsc" ], "type": "string", "description": "Order of the results: newest first, highest pay first, or lowest pay first. Pay is ranked by the middle of the yearly range, so one very wide range cannot outrank a solid one.", "default": "newest" }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 20000, "type": "integer", "description": "You are charged per result returned, so this is also your cost cap.", "default": 100 } } }, "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 } } } } } } } } } }