{ "openapi": "3.0.1", "info": { "title": "Jobs Feed: New Job Postings from 45k+ Career Sites, Daily", "description": "A bulk feed of new job postings for daily data pipelines: each run delivers the fresh jobs added since your last run to our index of 2M jobs from 49,000 company career sites on 19 ATSs, once, with no gaps. Filter by country, title, remote and ATS. For data warehouses, job boards and AI agents.", "version": "0.1", "x-build-id": "v8fqeDV8Y8LiO0j9s" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jamie_developer~jobs-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jamie_developer-jobs-feed", "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/jamie_developer~jobs-feed/runs": { "post": { "operationId": "runs-sync-jamie_developer-jobs-feed", "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/jamie_developer~jobs-feed/run-sync": { "post": { "operationId": "run-sync-jamie_developer-jobs-feed", "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": { "countries": { "title": "Countries", "type": "array", "description": "Deliver only jobs in these countries. English names (United States, Germany, United Kingdom) or ISO codes (US, DE, GB). The country comes from the ATS when it gives one, otherwise from the location text; jobs whose country can't be determined, such as 'Remote' with no country, are left out when this is set. Leave empty for every country.", "items": { "type": "string" } }, "titleKeywords": { "title": "Job title contains any of", "type": "array", "description": "Deliver only jobs whose title contains at least one of these keywords, e.g. engineer, nurse, sales. Case-insensitive; a keyword matches at the start of a word, so engineer also finds Engineering. Leave empty for all titles.", "items": { "type": "string" } }, "excludeTitleKeywords": { "title": "Job title contains none of", "type": "array", "description": "Leave out jobs whose title contains any of these keywords, e.g. intern, senior. Same matching as above.", "items": { "type": "string" } }, "workplaceType": { "title": "Workplace type", "type": "array", "description": "Deliver only remote, hybrid and/or on-site jobs. Most ATSs only flag remote and hybrid jobs, so On-site also includes jobs with no remote or hybrid indication. Leave empty for all.", "items": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ], "enumTitles": [ "Remote", "Hybrid", "On-site (or not stated)" ] } }, "ats": { "title": "Applicant tracking systems", "type": "array", "description": "Deliver only jobs from these job board platforms, one per line. The index covers greenhouse, smartrecruiters, workday, lever, ashby, workable, teamtailor, paylocity, bamboohr, recruitee, softgarden, breezy, personio, rippling, jobvite, join, comeet, pinpoint and dvinci. Every run's SUMMARY record lists the platforms and job counts in the current index. Leave empty for all.", "items": { "type": "string" } }, "firstRunDays": { "title": "First run: jobs posted in the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "What the feed's first run delivers: the matching jobs whose posting date is in the last N days. Jobs without a posting date (some platforms publish none) start arriving with later runs. 0 = every matching job in the index. Later runs ignore this and deliver every job added to the index since the previous run.", "default": 1 }, "maxAgeDays": { "title": "Later runs: skip jobs posted more than N days ago", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Later runs deliver jobs that are new to the index. When the index starts reading a company's career site for the first time, its older openings are new to the index too; this leaves out the ones whose posting date is more than N days old, so the feed carries fresh postings. Jobs without a posting date are always delivered. 0 = no limit.", "default": 14 }, "feedName": { "title": "Feed name (optional)", "type": "string", "description": "The feed remembers which jobs it delivered, per set of filters. Leave empty to derive the name from the filters (changing a filter then starts a new feed); set a name to keep the position when you change filters, or to run two feeds with the same filters. Stored in a key-value store named jobs-feed-state in your account." }, "maxJobs": { "title": "Max jobs per run", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Deliver at most this many jobs per run (up to 200,000). Jobs over the limit are not lost: the next run starts with them. You pay per job delivered, so this also caps the cost of a run.", "default": 50000 } } }, "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 } } } } } } } } } }