Skip to main content
POST
cURL

Authorizations

X-Api-Key
string
header
required

API key provided by Jobo

Path Parameters

feed_id
string<uuid>
required

The feed's id, shown in the portal's Feed Builder.

Body

application/json

Cursor-paginated export request for a saved feed. The feed's rules, edited in the Jobo portal, decide what is in it; only pagination, the incremental watermark and the description format are set per request.

cursor
string | null

Opaque cursor from next_cursor. Omit on the first request. The cursor embeds the feed's revision, the batch size and updated_after, so those values sent alongside it are ignored — except batch_size, which a continuation may reduce but never raise.

batch_size
integer
default:1000
Required range: 1 <= x <= 1000
updated_after
string<date-time> | null

Only return jobs created, updated or re-indexed on or after this UTC timestamp — incremental watermark for syncs — plus every job of a company that joined the feed on or after it. Ignored on continuations.

description_format
enum<string>
default:markdown

Format of each job's description. markdown (default) returns it as stored. html renders it to HTML on the fly: raw HTML in the source is escaped and only http(s), mailto and relative URLs are kept. Read from every request, including cursor continuations.

Available options:
markdown,
html

Response

Batch of jobs from the saved feed with cursor for next page

jobs
object[]
required
next_cursor
string | null
required
has_more
boolean
required
feed_id
string<uuid>
required
feed_revision
integer
required

The feed's revision this page was read at. When it differs from the one your last full scan used, the feed was edited: run a full scan.

estimated_total
integer<int64> | null

Estimated number of jobs the scan will deliver. Present on the first page of a scan only; null on continuation pages.