Jobopportunitiesapi

Job Opportunities API

Every listing here comes from an employer ATS, a company's own careers page, a public employment agency, or a direct submission. Redistribution is enforced by…

Data & analytics#jobs

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Every listing here comes from an employer ATS, a company's own careers page,
a public employment agency, or a direct submission. Redistribution is
enforced by a database JOIN, not a filter someone can forget.

Three things this API does that a job feed normally does not:

  • It says which fields it guessed. Every job carries field_sources,

naming each field as published (carried by the source), inferred
(derived by us) or absent. 79.1% of live listings have an inferred
remote status; 20.8% have one the source actually stated. Filter with
remote_confirmed=true to get only the latter.

  • It says when each row was last verified. last_verified_at is the last

positive confirmation at the source (the posting's own page or ATS API record
found live, or the posting listed in a fresh read of the employer's job list;
otherwise its first harvest), not when it was posted; last_verified_via names
which. GET /v1/meta/freshness publishes the coverage numbers.

  • It keeps what closed. GET /v1/jobs/closed returns roles that have

come off their source, with the reason and the date. A req that opened
and closed in nine days is a hiring signal, not a dead link. The date is
the day JOA's daily verification confirmed the advert had gone; before
late September 2026 that verification ran in large catch-up batches, so
earlier closure dates show when JOA confirmed a closure, not when the
employer closed the role.

Changelog 2026-10-07: new contract fields engagement,
contract_category, agency and working_schedule, each with
field_sources provenance and filters (?engagement=,
?contract_category=, ?agency=, ?working_schedule=; absence token
unknown, alias not_stated). Values appear only when the posting or the
source states them (or, later, when an audited rule establishes them):
most postings will show unknown at launch, and that is the honest answer,
not a defect. contract_category=permanent returns only postings that
STATE permanence. Per-field coverage is published on /public/coverage.
employment_type is unchanged and frozen.

Counts in this document are not typed in: they come from the daily
statistics snapshot every page of the website uses (GET /public/site-stats):
2,443,847 live employer-direct listings (employer_direct_live) and
153,072 employers as of 2026-11-17.

This service uses the ESCO classification of the European Commission.
Occupation matches (esco_occupation_uri, esco_occupation_label,
isco_code) are our automated inference from the job title, not the
employer's classification and not an official ESCO product; they are
marked inferred in field_sources.occupation and left out when the
title is not an exact match.

Endpoints 27

jobs

  • GETDelta feed: created, updated, withdrawn and delisted, in change order./v1/changes?since=stringPoll this instead of re-reading the ledger. Pass since on the first call and the returned next_since from then on; it is a keyset cursor of…
  • GETBulk export of the full corpus, as a stream of NDJSON./v1/exportOne JSON object per line, not a JSON array: the stream can be processed as it arrives, and a dropped connection costs one line rather than the whole document.…
  • GETBETA: list this account's export packs./v1/export-packsNewest first, up to 50. Each row carries status (queued, running, completed, failed) and, once completed, a signed download_url.
  • POSTBETA: queue a background whole-country export pack./v1/export-packsRequires a plan with bulk_export (same gate as GET /v1/export). Creates a background job that pages the full corpus for one country (optionally narrowed to…
  • GETBETA: one export pack's status./v1/export-packs/:id
  • GETList listings, newest first./v1/jobsKeyset pagination on (posted_at DESC NULLS LAST, id DESC). Pass the next_cursor from each response back as cursor. Offsets are not offered here: at this scale…
  • GETRoles that have left their source, most recently closed first./v1/jobs/closedKeyset pagination on (closed_at DESC, id DESC). Closure dates: JOA records as the closure date the day its daily verification confirmed that an advert had…
  • GETSemantic search, more like this job/v1/jobs/similar?job_id=stringThe nearest SERVED jobs to a query vector, by cosine similarity, with every GET /v1/jobs filter. The query is the stored vector of a job (job_id, more like…
  • POSTSemantic search by text, vector or job_id/v1/jobs/similarThe nearest SERVED jobs to a query vector, by cosine similarity, with every GET /v1/jobs filter. The query is the stored vector of a job (job_id, more like…
  • POSTStatus of up to 1000 job ids in one call/v1/jobs/statusFor a copy you keep yourself (9 Nov 2026): send the ids you hold, get each one's current status without re-reading the rows. Per id: status (live, closed,…
  • GETIds of roles that left the served set without closing/v1/jobs/withdrawn?since=stringThe sibling of /v1/jobs/expired. A role can leave what this API serves without closing: a duplicate or freshness hold, a quality rule, the employer…
  • GETOne listing, with its description./v1/jobs/:idA served listing comes back in full (one record). A listing that WAS served and has since been withdrawn (anything but a closure: a hold, a quality rule, an…

companies

  • GETEmployers whose live roles this API returns./v1/companiesEvery company here has at least one live listing you can fetch, so open_roles and GET /v1/jobs?company=<slug> reconcile. That is the point of the endpoint: a…
  • GETOne employer./v1/companies/:slug
  • GETIs this employer on an official sponsor register? One employer./v1/sponsors/lookup?name=stringThe one-employer form of POST /v1/sponsors/lookup (added 10 Nov 2026): the same answer for name, optional country, town and region. Works for any employer…
  • POSTEmployer sponsor lookup, up to 100 employers per call/v1/sponsors/lookupAdded 10 Nov 2026. For each employer you name, whether it appears on an official government sponsor register JOA reads: the UK Home Office register of…

meta

  • GETThis document, with every endpoint and parameter, the query grammar, the limits, the error codes and a worked example per endpoint./v1/helpThe API describing itself, machine readable. Also served keyless as /public/help, because an agent should be able to read the contract before it has a key. It…
  • GETYour key, plan and quota./v1/meCosts no records. usage_today counts REQUESTS today (the per_day burst limit); the billed unit is records: records_used_month of records_limit_month (null =…
  • GETApproximately how many rows a search would return, and whether the CSV export tool would use your plan's remaining allowance./v1/me/export-estimateAccepts the same filters as GET /v1/jobs. Free to call: it never returns rows and consumes no record quota. estimated_rows is the query planner's…
  • GETRequests served per day, for the dashboard's usage chart./v1/me/usage
  • GETEvery filter value with its live count./v1/meta/facetsFacet keys: family, country, city, remote, employment, seniority, source_type, remote_source, provider, field, compensation_type (db/370, the commission-only…
  • GETHow recently the ledger was verified, and how much of it is inferred./v1/meta/freshnessThe claim the subscription is sold on, made checkable. Every live listing is re-confirmed at its source on a rolling cycle; this reports the coverage, plus…
  • GETEvery source the ledger is built from, with its live row count./v1/meta/providersThe list ?provider= and ?exclude_provider= accept. A value that is not here is a 422, never a silently empty page, so you can always tell "no jobs match" from…

public

  • GETBETA: partial data. One company's open-roles count over 30/90/365 days; real daily snapshots from 2026-10-06./public/companies/:slug/open-roles-historyKeyless. Reads a snapshot of joa.companies.open_roles (already maintained by refresh_companies()), taken by joa.snapshot_company_open_history() into…
  • GETBETA: partial data. Daily trend of Market Signals segments (salary percentiles, time-to-fill, listing counts) over 30/90/365 days./public/market-signals/historyKeyless. Reads a once-a-day snapshot of the same rollup GET /public/market-signals reads live (joa.market_signal_segments), taken by…
  • GETThe site's headline numbers, one name and one definition each (daily snapshot)./public/site-statsKeyless. The single source of every headline number on jobopportunitiesapi.org, /public/stats, /public/coverage, llms.txt and apis.json. Taken once a day…
  • GETIds of roles that have come off the ledger/v1/jobs/expired?since=stringThe cheap half of /v1/jobs/closed. Returns id, closed_at and closed_reason only: enough to mark rows stale in your own database without transferring the jobs…

API details

Base URL
https://api.jobopportunitiesapi.org
Authentication
A bearer token in the Authorization header
Operations
27 operations on 24 pathsGET 23POST 4
Main resources
jobs 12meta 7companies 4public 3
Response formats
application/json application/x-ndjson
Description format
OpenAPI 3.1.0, API version 2026-11-11

How to test the Job Opportunities API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Job Opportunities API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Delta feed: created, updated, withdrawn and delisted, in change order.” (GET /v1/changes?since=string), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Job Opportunities API?

Every listing here comes from an employer ATS, a company's own careers page, a public employment agency, or a direct submission. Redistribution is enforced by… It is listed under Data & analytics and has 27 endpoints.

Who publishes the Job Opportunities API?

It is listed from Jobopportunitiesapi's public API description (an OpenAPI document), not published by Jobopportunitiesapi on Swastik Codes. Anyone who controls jobopportunitiesapi.org can claim the profile by adding a DNS TXT record.

What is the base URL of the Job Opportunities API?

Requests go to https://api.jobopportunitiesapi.org. Endpoint paths are added to this base URL.

How do I authenticate with the Job Opportunities API?

With A bearer token in the Authorization header.

How many endpoints does the Job Opportunities API have?

27 operations on 24 paths (23 GET, 4 POST). The largest groups are jobs, meta, companies, public.

Is forking the Job Opportunities API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.