{ "openapi": "3.0.1", "info": { "title": "Company Jobs Scraper — Hiring Signals from 5 Job Boards", "description": "Hiring signals for lead gen: every open job at the companies you list, with title, location, salary, posted date and apply link from Greenhouse, Lever, Ashby, SmartRecruiters and Workable. Get it daily, weekly or monthly with Apify schedules, n8n, Make or Zapier. Companies without jobs are free.", "version": "1.0", "x-build-id": "2LJQ1NmBlFTYjjhci" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fermaja~company-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fermaja-company-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/fermaja~company-jobs-scraper/runs": { "post": { "operationId": "runs-sync-fermaja-company-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/fermaja~company-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-fermaja-company-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": { "companies": { "title": "Companies", "type": "array", "description": "One per line (or comma-separated). Company websites (ramp.com), careers pages, job board URLs (jobs.lever.co/acme, boards.greenhouse.io/acme, jobs.ashbyhq.com/acme, jobs.smartrecruiters.com/Acme, apply.workable.com/acme) or company names. The job board is detected automatically.", "items": { "type": "string" } }, "datasetId": { "title": "Or: dataset from another Actor", "type": "string", "description": "Pick a dataset from another run (or pass its ID, e.g. {{ $json.defaultDatasetId }} in n8n), such as a Google Maps or website contact scraper result. Its website column is read automatically." }, "datasetField": { "title": "Website column in that dataset", "type": "string", "description": "Name of the field with the company website. Dot notation works (company.website). If empty in every row, a website/url/domain column is used instead.", "default": "website" }, "jobTitleKeywords": { "title": "Job title keywords", "type": "array", "description": "Keep only jobs whose title, department or team contains one of these words, e.g. sales, SDR, marketing, data engineer. Leave empty for all jobs.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude jobs with these words", "type": "array", "description": "Drop jobs whose title contains one of these words, e.g. intern, senior.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Keep only jobs whose location contains one of these, e.g. London, Germany, NY, Remote. Leave empty for everywhere.", "items": { "type": "string" } }, "workplaceTypes": { "title": "Workplace type", "type": "array", "description": "remote, hybrid or onsite. Leave empty for all.", "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within (days)", "type": "integer", "description": "Only jobs published in the last N days (0 = any). Fresh postings are the strongest buying signal.", "default": 0 }, "maxJobsPerCompany": { "title": "Max jobs per company", "type": "integer", "description": "Newest matching jobs first. Keeps cost predictable on companies with thousands of openings.", "default": 100 }, "maxCompanies": { "title": "Max companies", "type": "integer", "description": "Stop after this many companies (0 = all). Handy for a quick test on a long list.", "default": 0 }, "includeDescription": { "title": "Include job description text", "type": "boolean", "description": "Adds descriptionText (plain text, up to 5,000 characters) to each job. Useful for AI scoring or personalised outreach.", "default": false }, "includeCompaniesWithoutJobs": { "title": "Add a free row for companies without a job board or matching jobs", "type": "boolean", "description": "One free row per company where no board or no matching job was found, with the reason in status. Turn off to keep only job rows.", "default": true }, "onlyNewJobs": { "title": "Only new jobs since the last run", "type": "boolean", "description": "For daily, weekly or monthly schedules: jobs already returned by an earlier run with the same Monitor ID are skipped (and not charged).", "default": false }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Name of the memory used by the option above, stored in your own account (key-value store company-jobs-monitor). Use a different ID per list.", "default": "default" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Job board APIs work without a proxy. Only if you see rate-limit errors, enable Apify Proxy (datacenter); it is used only after repeated rate limits.", "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 } } } } } } } } } }