Skip to main content
POST
cURL

Authorizations

X-Api-Key
string
header
required

Your Jobo API key. Create one in the dashboard under Developers → API Keys. Live keys start with jbe_live_ and sandbox keys with jbe_test_.

Path Parameters

feed_id
string<uuid>
required

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

Body

application/json

Cursor-paginated export request for a saved feed. The feed's rules, edited in the dashboard's Feed Builder, 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. enhanced returns the enhanced Markdown and enhanced_html the same as HTML (both beta: the layout is automatic and not guaranteed to be perfect); a job without an enhanced copy gets the standard description. The cursor keeps the format of the first request; a continuation that sends one gets that format for that page. See Description format.

Available options:
markdown,
html,
enhanced,
enhanced_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 content revision when this page was read. It changes when the feed's source, conditions or excluded companies change, not on a rename. If it differs from your last full scan's revision, the feed selects different jobs: 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.