Skip to main content
All paths share one base URL, https://connect.jobo.world, and take your API key in the X-Api-Key header:
  • GET /api/companies/{id} is the only anonymous endpoint.
  • Paths have no version segment; see Versioning.
  • Sandbox keys (jbe_test_…) call the same host but work only on some endpoints.
A misspelled filter value matches nothing and returns 200, not an error. Unknown parameters are ignored: search flags them in warnings and the X-Jobo-Warnings header, but the feed drops them silently. See silent failures.

Endpoints

“Per delivered job” means you pay for the jobs a page returns, so an empty page is free. “Per new job” applies to the feeds: you pay only for the jobs on a page that are new to you, meaning you have not received them through Feed, Export, or Outbound in the last 30 days. Prices are on Billing and budgets per group on Rate limits.

Jobs and occupations

Feed

The managed and saved feeds need a customer API key. Master and marketplace keys get 403; sandbox keys get 404 with code: not_available_in_sandbox.

Companies and locations

Company Enrichment (both by-domain endpoints) is a beta, available on activation through support@jobo.world. Until then, both return 403 with code: company_enrichment_not_enabled and cost nothing. Enrich companies explains when a 202 and its poll are charged.

Auto Apply

Auto Apply is coming soon; pricing will be announced at launch. Build against the sandbox today with a jbe_test_… key, no approval needed. Live applications need Jobo to approve your business: request it in the dashboard under Auto Apply → Getting started → Request live access. Mailbox endpoints return 403 auto_apply_not_enabled until Jobo enables Auto Apply on your account, even with a sandbox key. A sandbox key can’t connect or delete a mailbox (mailbox access).

Resources

Jobs

Keyword search with typed filters and facets, plus single-job lookup. Page-based and relevance-ranked by default.

Occupations

The taxonomy behind every job’s occupation: categories, subcategories and occupations to filter and facet on.

Feed

Cursor-paginated bulk delivery plus expired job IDs, for keeping your own datastore in sync.

Companies

Company profiles (funding, ratings, technologies, H-1B data), company-scoped job lists, and Company Enrichment by domain (beta).

Locations

Resolve free-text location strings to canonical labels and coordinates.

Auto Apply — Coming soon

Synchronous application submission: create an application, answer its typed fields, and get the result. Build against the sandbox today.

Before you build

Authentication

Key format, the 5-key limit, and rotation.

Errors

Three envelopes, stable codes, and silent failures.

Rate limits

Per-group budgets across three windows.

Pagination

Page-based search and cursor-based feeds.

Idempotency

Retry writes without double-charging.

Sandbox

Free fictional data on the same host, selected by your key.

Response headers

Every X- header and where it appears.

Billing

Per-job metering, included jobs, and the wallet.

Versioning

No version in the path, and an additive change contract.