Stream the job feed

Export active jobs in batches of up to 1,000. Omit cursor on the first request, then pass only the returned next_cursor — the cursor embeds the initial filters and batch size, and values sent alongside a cursor are ignored. Persist the cursor so an interrupted scan can resume, and paginate serially (one in-flight request per cursor).

New scans default to stable_scan: true: pages follow immutable creation time, so mid-scan updates or deletions cannot shift records across page boundaries. Set stable_scan: false explicitly for the legacy update-recency ordering. Use updated_after for incremental additions and edits after the backfill.

Retry only 503 (honoring Retry-After) and 429, with bounded backoff. A 400 for a malformed cursor, or a 409 with code feed_cursor_restart_required, means discard the cursor and restart the scan with stable_scan: true. Configure clients with a response timeout of at least 120 seconds.

POST /api/jobs/feed

cURL

cURL

# First request carries the filters and batch size.
curl -X POST "https://connect.jobo.world/api/jobs/feed" \
  -H "X-Api-Key: $JOBO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sources": ["greenhouse"], "batch_size": 1000}'

# Continuation requests carry ONLY the cursor.
curl -X POST "https://connect.jobo.world/api/jobs/feed" \
  -H "X-Api-Key: $JOBO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cursor": "eyJ2IjoxLCJ..."}'

200

{
  "jobs": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "normalized_title": "<string>",
      "company": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "website": "<string>",
        "logo_url": "<string>",
        "summary": "<string>",
        "industries": [
          "<string>"
        ],
        "categories": [
          "<string>"
        ],
        "linkedin_url": "<string>",
        "crunchbase_url": "<string>",
        "details_url": "<string>"
      },
      "description": "<string>",
      "summary": "<string>",
      "listing_url": "<string>",
      "apply_url": "<string>",
      "locations": [
        {
          "location": "<string>",
          "city": "<string>",
          "region": "<string>",
          "country": "<string>",
          "latitude": 123,
          "longitude": 123
        }
      ],
      "compensation": {
        "min": 123,
        "max": 123,
        "currency": "<string>"
      },
      "source": "greenhouse",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "date_posted": "2023-11-07T05:31:56Z",
      "valid_through": "2023-11-07T05:31:56Z",
      "qualifications": {
        "must_have": {
          "education": [
            "<string>"
          ],
          "certifications": [
            "<string>"
          ],
          "skills": [
            {
              "name": "<string>",
              "type": "hard"
            }
          ]
        },
        "preferred": {
          "education": [
            "<string>"
          ],
          "certifications": [
            "<string>"
          ],
          "skills": [
            {
              "name": "<string>",
              "type": "hard"
            }
          ]
        }
      },
      "responsibilities": [
        "<string>"
      ],
      "benefits": [
        "<string>"
      ],
      "is_work_auth_required": true,
      "is_h1b_sponsor": true,
      "is_clearance_required": true
    }
  ],
  "next_cursor": "<string>",
  "has_more": true,
  "estimated_total": 123
}

Authorizations

X-Api-Key · string · header · required

API key provided by Jobo

Body

application/json

Cursor-paginated export request. The cursor preserves the filters and batch size from the first request; start a new scan to change them.

locations · object[] | null

Show child attributes

sources · string[] | null

work_models · enum<string>[] | null

Filter by work model: remote, hybrid, onsite. null = all jobs

Available options: remote, hybrid, onsite

employment_types · enum<string>[] | null

Filter by employment type. null = all jobs

Available options: full-time, part-time, contract, internship, freelance, temporary

experience_levels · enum<string>[] | null

Filter by experience level. null = all jobs

Available options: intern, entry, mid, senior, lead, executive

posted_after · string<date-time> | null

Return jobs whose employer posting time or first-indexed time is on or after this UTC timestamp. Use updated_after when edits matter.

updated_after · string<date-time> | null

Return jobs created or updated on or after this UTC timestamp.

stable_scan · boolean · default: true

Page by immutable creation time rather than update recency (default). Stable scans cannot skip or duplicate records when jobs are updated or deleted mid-scan. Set false explicitly for the legacy update-recency ordering.

cursor · string | null

Opaque cursor from next_cursor. Omit on the first request.

batch_size · integer · default: 1000

Required range: 1 <= x <= 1000

Response

200

application/json

Batch of jobs with cursor for next page

jobs · object[] · required

Show child attributes

next_cursor · string | null · required

has_more · boolean · required

estimated_total · integer<int64> | null

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