{ "openapi": "3.0.1", "info": { "title": "iCIMS Jobs Scraper: Career Sites & Portals [USD 0.39/1K]", "description": "Scrape iCIMS career sites in one Actor: classic *.icims.com portals and iCIMS Attract (Jibe) sites on the employer's own domain. Title, place, dates, job type, category, pay from the portal's own fields, full description and apply link. USD 0.39 per 1,000 jobs.", "version": "1.0", "x-build-id": "dhLXsk9yhzjzVz8in" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/usefulapi~icims-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-usefulapi-icims-jobs-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/usefulapi~icims-jobs-scraper/runs": { "post": { "operationId": "runs-sync-usefulapi-icims-jobs-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/usefulapi~icims-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-usefulapi-icims-jobs-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": { "sites": { "title": "iCIMS career sites", "type": "array", "description": "Career sites, one per line. Two kinds work: (1) iCIMS-hosted portals, https://careers-.icims.com/jobs/search (any *.icims.com address), and (2) iCIMS Attract (Jibe) sites on the employer's own domain, for example https://careers.costco.com or https://careers.mountsinai.org. The kind is read from the address. Open the employer's careers page, click through to its job search and copy the address. There is no public list of iCIMS employers, so you give the ones you want.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keywords": { "title": "Search words", "type": "array", "description": "One search per line. On Attract (Jibe) sites the site's own search runs over titles and descriptions. On iCIMS-hosted portals every word must be in the job title as written in the job's web address (security officer, nurse); those portals have no usable search page. Leave empty to read every job.", "items": { "type": "string" } }, "locations": { "title": "Places (any of)", "type": "array", "description": "Keep only jobs whose place contains one of these (Texas, Seattle, NY). On Attract sites this is checked on the list; on iCIMS-hosted portals the place is only known after the job page is read, so unwanted jobs are read but not saved or charged.", "items": { "type": "string" } }, "companyName": { "title": "Company name (optional)", "type": "string", "description": "Attract sites and most portals name the employer in their data; some portals print 'UNAVAILABLE'. Write a name here to use it for every row of the run instead." }, "maxJobs": { "title": "Maximum jobs", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after saving this many jobs (across all searches). You pay only for jobs saved.", "default": 50 }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only jobs published in the last N days. 0 = any date.", "default": 0 }, "onlyNewJobs": { "title": "Only new jobs since the last run", "type": "boolean", "description": "Remembers the jobs already delivered for these searches (in a key-value store on your account) and saves only jobs not seen before. Ideal for daily or hourly schedules and job alerts. The first run delivers everything and remembers it.", "default": false }, "stateKey": { "title": "Memory name for new-jobs mode (optional)", "pattern": "^[A-Za-z0-9_-]{0,60}$", "type": "string", "description": "Use the same name on several schedules to share one memory, or a new name to start fresh. Letters, digits, - and _. Empty = one memory per set of searches." }, "includeDetails": { "title": "Open each job page for full details", "type": "boolean", "description": "Reads each job's own page for the full description and extra fields. Turn off for faster runs with list fields only (same price per job).", "default": true }, "notifyUrl": { "title": "Send new jobs to (optional)", "pattern": "^(https://.+)?$", "type": "string", "description": "Paste a Slack or Discord webhook link, or a Zapier or Make webhook (which can email you). After each run that saved jobs you get one message with the count and up to 10 jobs with their links. With 'Only new jobs' on and a schedule, this is a free job alert. Not billed." }, "descriptionFormat": { "title": "Description format", "enum": [ "both", "text", "html", "none" ], "type": "string", "description": "Plain text, HTML, both, or none (smaller datasets).", "default": "both" }, "maxJobsPerSearch": { "title": "Maximum jobs per search", "minimum": 0, "type": "integer", "description": "Cap for each search line, so one broad search does not use up the whole run. 0 = no cap.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed for iCIMS career sites in our tests. Apify datacenter proxy or your own proxies only; residential proxy is not supported.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }