Pricing

Pay per event

Try for free

Go to Apify Store

Employer-Direct Job Postings API (Job Opportunities API)

Try for free

Job postings straight from employer ATS (Greenhouse, Lever, Workday, Ashby and more), career sites and public agencies. No scraping, no proxies. Live and closed jobs, per-field provenance, pay per result.

Pricing

Pay per event

Rating

0.0

(0)

Developer

Loukas Tzekos

Actor stats

Bookmarked

Total users

Monthly active users

19 days ago

Last modified

Categories

Jobs

Lead generation

Automation

You can access the Employer-Direct Job Postings API (Job Opportunities API) programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "v8qn6juoV22nhjYil"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/job_opportunities_api~job-opportunities-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-job_opportunities_api-job-opportunities-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/job_opportunities_api~job-opportunities-api/runs": {
      "post": {
        "operationId": "runs-sync-job_opportunities_api-job-opportunities-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/job_opportunities_api~job-opportunities-api/run-sync": {
      "post": {
        "operationId": "run-sync-job_opportunities_api-job-opportunities-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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "jobs",
              "closed_jobs",
              "companies"
            ],
            "type": "string",
            "description": "What to fetch. Jobs = live vacancies. Closed jobs = roles that left their source (hiring signal). Companies = employers with open roles.",
            "default": "jobs"
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Hard cap on records returned (and billed). The run stops as soon as it is reached. Use Start cursor to continue a large pull in a later run.",
            "default": 25
          },
          "query": {
            "title": "Search text",
            "type": "string",
            "description": "Full-text over job title, company name and location (Jobs / Closed jobs), or over the company name (Companies). Example: data engineer berlin"
          },
          "titleQuery": {
            "title": "Title contains",
            "type": "string",
            "description": "Full-text over the job title only. ANDs with everything else. Jobs / Closed jobs only."
          },
          "titleExclude": {
            "title": "Title excludes",
            "type": "string",
            "description": "Drop rows whose title matches these words, e.g. intern trainee. Jobs / Closed jobs only."
          },
          "descriptionContains": {
            "title": "Description contains",
            "type": "string",
            "description": "Full-text over the advert body (only rows that carry a description). Example: kubernetes terraform. Jobs / Closed jobs only."
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "ISO-3166 alpha-2 codes, e.g. DE, GR, FR, NL. Empty = worldwide.",
            "items": {
              "type": "string"
            }
          },
          "excludeCountries": {
            "title": "Exclude countries",
            "type": "array",
            "description": "ISO-3166 alpha-2 codes to remove.",
            "items": {
              "type": "string"
            }
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "City name as it appears in the ledger, e.g. Berlin. Jobs / Closed jobs only."
          },
          "remote": {
            "title": "Work model",
            "type": "array",
            "description": "Remote / hybrid / on-site. Note: for most rows the work model is INFERRED — tick 'Only source-confirmed remote status' to keep rows where the employer stated it.",
            "items": {
              "type": "string",
              "enum": [
                "remote",
                "hybrid",
                "on_site",
                "not_stated"
              ],
              "enumTitles": [
                "Remote",
                "Hybrid",
                "On site",
                "Not stated"
              ]
            }
          },
          "remoteConfirmed": {
            "title": "Only source-confirmed remote status",
            "type": "boolean",
            "description": "Keep only rows whose remote status was published by the employer (not inferred by us).",
            "default": false
          },
          "employmentTypes": {
            "title": "Employment type",
            "type": "array",
            "description": "Full-time, Part-time, Contract, Temporary, Internship, or not_stated.",
            "items": {
              "type": "string",
              "enum": [
                "Full-time",
                "Part-time",
                "Contract",
                "Temporary",
                "Internship",
                "not_stated"
              ]
            }
          },
          "seniorities": {
            "title": "Seniority",
            "type": "array",
            "description": "Entry, Intern, Mid, Senior, Lead, Manager, Director, Executive, or not_stated. Seniority is inferred and only stated where confidence is high.",
            "items": {
              "type": "string",
              "enum": [
                "Intern",
                "Entry",
                "Mid",
                "Senior",
                "Lead",
                "Manager",
                "Director",
                "Executive",
                "not_stated"
              ]
            }
          },
          "categories": {
            "title": "Job category",
            "type": "array",
            "description": "Job family. 'uncategorised' selects rows without a confident classification.",
            "items": {
              "type": "string",
              "enum": [
                "Healthcare",
                "Engineering",
                "Operations & Admin",
                "Sales",
                "uncategorised",
                "Skilled Technician",
                "Hospitality",
                "Retail",
                "Finance",
                "Logistics & Transport",
                "Marketing",
                "Customer Support",
                "Education",
                "Manufacturing",
                "HR & Recruiting",
                "Data & Analytics",
                "Consulting & Strategy",
                "Construction & Trades",
                "Legal & Compliance",
                "Design",
                "Product",
                "Science & Research",
                "Security",
                "Procurement",
                "Safety & Environment"
              ]
            }
          },
          "sourceTypes": {
            "title": "Source type",
            "type": "array",
            "description": "Where the row comes from: Employer ATS, company career site, or public employment agency.",
            "items": {
              "type": "string",
              "enum": [
                "ats",
                "career_site",
                "public_agency"
              ],
              "enumTitles": [
                "Employer ATS",
                "Company career site",
                "Public employment agency"
              ]
            }
          },
          "companySlugs": {
            "title": "Company slugs",
            "type": "array",
            "description": "Restrict to specific employers by JOA slug (find slugs in Companies mode), e.g. e-vita-gmbh.",
            "items": {
              "type": "string"
            }
          },
          "companyDomains": {
            "title": "Company domains",
            "type": "array",
            "description": "Restrict to employers by bare domain (no scheme, no path), e.g. stripe.com, figma.com.",
            "items": {
              "type": "string"
            }
          },
          "hasSalary": {
            "title": "Only rows with a published salary",
            "type": "boolean",
            "description": "Keep only rows whose salary was published by the employer. Roughly 2% of the ledger carries structured salary — combine with a country to keep results useful.",
            "default": false
          },
          "minSalaryEurAnnual": {
            "title": "Minimum annual salary (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Lower bound on the normalised annual salary in EUR. Implies published salary."
          },
          "postedWithinDays": {
            "title": "Posted within (days)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Only roles posted in the last N days. Jobs / Closed jobs only."
          },
          "verifiedWithinDays": {
            "title": "Re-verified within (days)",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Only roles re-confirmed at their source in the last N days — the freshness filter. Most of the ledger is re-checked within 48 hours, so 2 is a good value. Jobs / Closed jobs only."
          },
          "closedWithinDays": {
            "title": "Closed within (days)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Closed jobs mode: only roles that closed in the last N days."
          },
          "closedReason": {
            "title": "Closed reason",
            "enum": [
              "",
              "expired_upstream",
              "not_seen",
              "employer_closed",
              "deadline_passed"
            ],
            "type": "string",
            "description": "Closed jobs mode: why the role left the ledger.",
            "default": ""
          },
          "includeDescription": {
            "title": "Include full advert text",
            "type": "boolean",
            "description": "Add the full job description (about 2.5 KB per row) in a description field. Same price per record.",
            "default": false
          },
          "companyOrgType": {
            "title": "Employer type",
            "type": "string",
            "description": "Companies mode only: organisation type filter, e.g. BPO, Staffing, Enterprise (see the values in Companies-mode output)."
          },
          "companyHasWebsite": {
            "title": "Only employers with a verified website",
            "type": "boolean",
            "description": "Companies mode only.",
            "default": false
          },
          "startCursor": {
            "title": "Start cursor",
            "type": "string",
            "description": "Resume a previous pull: paste the next_cursor from that run's SUMMARY record. Keep every other input identical."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Employer-Direct Job Postings API: ATS & Career Sites | JOA OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Employer-Direct Job Postings API (Job Opportunities API) from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Employer-Direct Job Postings API (Job Opportunities API) API in Python

Employer-Direct Job Postings API (Job Opportunities API) API in JavaScript

Employer-Direct Job Postings API (Job Opportunities API) API through CLI

Employer-Direct Job Postings API (Job Opportunities API) API

Arbeitsagentur Jobs Scraper

zilicon/german-jobs-scraper

Scrape German job listings and get title, employer, occupation, location, postcode, contract type, working time, remote flag, start date and apply URL. Filter by city and radius, sector, employer or posting age. No login, no account.

Zilicon

⚡ Indeed Jobs Scraper

vero-api/indeed-jobs-scraper

Scrape Indeed job listings by keyword and location, or paste an Indeed jobs search URL. Get titles, companies, salaries, full descriptions, skills, and company details as clean JSON. No login needed.

VeroAPIs

TheirStack Job Search Scraper

comfy_glove/theirstack-job-scraper

Search and export jobs from TheirStack API with full filter control.

Zsombor Szekeres

LinkedIn Jobs Scraper

pramodkonde17/linkedin-jobs-scraper

Scrape job listings from LinkedIn's public job search

Pramod Konde

110

Dice Jobs Scraper

axiomworks/dice-jobs-scraper

Scrape Dice search results and return job titles, companies, locations, employment types, posting dates, salary, summaries and application links. You can optionally fetch each job page for skill tags, the full description and its closing date, or skip details for a lighter collection.

Axiom Works

Career Site Jobs API (Greenhouse, Lever, Ashby, Workday +1)

webdatatools/career-site-jobs-api

Career Site Jobs API finds which ATS a company uses (Greenhouse, Lever, Ashby, SmartRecruiters, Workday) from its domain or name and returns its open jobs in one unified format, $3 per 1,000 jobs.

Murat Uzun

Validated Jobs Scraper: Dedup, No Ghost Jobs, Confidence Scored

jan_hilgard/validated-jobs-scraper

Job data with a correctness guarantee: per-field confidence, ghost-job filtering and cross-source dedup — never silently wrong, duplicated or expired. Reaches LinkedIn and ATS boards cookieless, gets through Cloudflare/DataDome, self-healing on layout shifts. Built on the data.hilgard.cz engine.

Jan Hilgard

ATS Job Listings API Scraper — 1,639 Boards, 6 Platforms

deadwood_data_solutions/greenhouse-lever-ashby-workable-jobs-api

Query 1,639 verified job boards — 60,983 live roles across Greenhouse, Lever, Ashby, SmartRecruiters, Recruitee and Workable. Filter by seniority, employment type, workplace, country, salary floor, plus keyword and company excludes. Schedule it and pay only for jobs you have not seen before.

K O

Jobware Job Scraper: German Jobs with Company and Location

bogdiehard/jobware-de-job-scraper

Extracts German job postings from jobware.de with title, company, location, posting date and remote flag. Optional full description for jobs with a public job page. Public data only.

Demetrius Greses Jr

Handshake Campus Jobs & Employer Showcase Extractor

dataspryva/handshake-campus-jobs-and-employer-showcase

Reads Handshake's public job explore page for campus internships and entry-level roles, plus the public employer showcase, returning title, company, location, salary, and deadline.