> ## Documentation Index
> Fetch the complete documentation index at: https://jobo.world/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.




## OpenAPI

````yaml /openapi.yaml post /api/jobs/feed
openapi: 3.0.3
info:
  title: Jobo Enterprise API
  description: >
    The Jobo Enterprise API provides programmatic access to job listings,
    intelligent search,

    real-time feeds, geocoding services, and a contract preview for
    callback-driven

    job applications. Auto Apply is coming soon and is not available in beta or
    production.
  version: '2026-07-21'
  contact:
    name: Jobo Support
    url: https://jobo.world
    email: support@jobo.world
  license:
    name: Proprietary — see terms of service
    url: https://jobo.world/terms
  termsOfService: https://jobo.world/terms
servers:
  - url: https://connect.jobo.world
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Jobs
    description: Search and retrieve job listings
  - name: Feed
    description: Bulk job feeds and expiration tracking
  - name: Companies
    description: Company profiles and company-scoped job listings
  - name: Auto Apply
    description: >-
      Coming soon: profileless applications answered through signed, typed HTTPS
      callbacks
  - name: Locations
    description: Geocoding and location services
paths:
  /api/jobs/feed:
    post:
      tags:
        - Feed
      summary: Stream the job feed
      description: >
        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.
      operationId: getJobFeed
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JobFeedRequest'
      responses:
        '200':
          description: Batch of jobs with cursor for next page
          headers:
            X-Has-More:
              schema:
                type: boolean
              description: Duplicates response body `has_more` for quick checks.
            X-Credits-Deducted:
              schema:
                type: integer
              description: |
                Credits debited for this request. Absent for callers whose plan
                includes the feed or whose key bypasses wallet debits.
            X-Credits-Balance:
              schema:
                type: integer
              description: Remaining credit balance after this call (when debit applied).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobFeedResponse'
        '400':
          description: Invalid request (e.g., batch_size out of range, malformed cursor)
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '409':
          description: |
            A legacy non-stable cursor reached the 1,000,000-result deep
            pagination boundary. The cursor cannot be retried; discard it and
            start a new scan with stable_scan set to true.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/ServerError'
        '503':
          description: |
            Feed search backend temporarily unavailable. Clients should respect
            the Retry-After response header (5 seconds) before retrying.
          headers:
            Retry-After:
              schema:
                type: integer
              description: Seconds the client should wait before retrying.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      x-codeSamples:
        - lang: cURL
          source: |
            # 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..."}'
        - lang: Python
          source: |
            from jobo_enterprise import JoboClient

            with JoboClient(api_key="YOUR_API_KEY") as client:
                # iter_jobs walks the cursor for you.
                for job in client.feed.iter_jobs(sources=["greenhouse"], batch_size=1000):
                    save_to_database(job)
components:
  schemas:
    JobFeedRequest:
      type: object
      description: |
        Cursor-paginated export request. The cursor preserves the filters and
        batch size from the first request; start a new scan to change them.
      properties:
        locations:
          type: array
          items:
            $ref: '#/components/schemas/LocationFilter'
          nullable: true
        sources:
          type: array
          items:
            type: string
          nullable: true
        work_models:
          type: array
          items:
            type: string
            enum:
              - remote
              - hybrid
              - onsite
          nullable: true
          description: 'Filter by work model: remote, hybrid, onsite. null = all jobs'
        posted_after:
          type: string
          format: date-time
          nullable: true
          description: |
            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:
          type: string
          format: date-time
          nullable: true
          description: Return jobs created or updated on or after this UTC timestamp.
        stable_scan:
          type: boolean
          default: true
          description: |
            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:
          type: string
          nullable: true
          description: Opaque cursor from `next_cursor`. Omit on the first request.
        batch_size:
          type: integer
          default: 1000
          minimum: 1
          maximum: 1000
    JobFeedResponse:
      type: object
      required:
        - jobs
        - next_cursor
        - has_more
      properties:
        jobs:
          type: array
          items:
            $ref: '#/components/schemas/JobDto'
        next_cursor:
          type: string
          nullable: true
        has_more:
          type: boolean
    ProblemDetails:
      type: object
      description: Problem Details object returned for error responses.
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        code:
          type: string
          nullable: true
          description: Stable machine-readable code for Auto Apply domain errors.
        api_version:
          $ref: '#/components/schemas/AutoApplyApiVersion'
    LocationFilter:
      type: object
      properties:
        country:
          type: string
          nullable: true
        region:
          type: string
          nullable: true
        city:
          type: string
          nullable: true
    JobDto:
      type: object
      required:
        - id
        - title
        - normalized_title
        - company
        - description
        - summary
        - listing_url
        - apply_url
        - locations
        - compensation
        - employment_type
        - workplace_type
        - experience_level
        - source
        - created_at
        - updated_at
        - date_posted
        - valid_through
        - qualifications
        - responsibilities
        - benefits
        - is_work_auth_required
        - is_h1b_sponsor
        - is_clearance_required
      properties:
        id:
          type: string
          format: uuid
        title:
          type: string
        normalized_title:
          type: string
          nullable: true
        company:
          $ref: '#/components/schemas/JobCompanyDto'
        description:
          type: string
        summary:
          type: string
          nullable: true
        listing_url:
          type: string
        apply_url:
          type: string
        locations:
          type: array
          items:
            $ref: '#/components/schemas/JobLocationDto'
        compensation:
          type: object
          allOf:
            - $ref: '#/components/schemas/JobCompensationDto'
          nullable: true
          description: |
            Compensation as published by the employer. USD annualization is
            used for salary filters but is not returned in this object.
        employment_type:
          type: string
          nullable: true
          enum:
            - Full-time
            - Part-time
            - Contract
            - Internship
            - Freelance
            - Temporary
        workplace_type:
          type: string
          nullable: true
          enum:
            - Remote
            - Hybrid
            - On-site
        experience_level:
          type: string
          nullable: true
          enum:
            - Intern
            - Entry Level
            - Mid Level
            - Senior
            - Lead
            - Executive
        source:
          type: string
          example: greenhouse
          description: |
            ATS provider identifier. This remains an open string so newly
            supported providers do not break generated clients.
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        date_posted:
          type: string
          format: date-time
          nullable: true
        valid_through:
          type: string
          format: date-time
          nullable: true
        qualifications:
          $ref: '#/components/schemas/JobQualificationsDto'
        responsibilities:
          type: array
          items:
            type: string
        benefits:
          type: array
          items:
            type: string
        is_work_auth_required:
          type: boolean
          nullable: true
        is_h1b_sponsor:
          type: boolean
          nullable: true
        is_clearance_required:
          type: boolean
          nullable: true
    AutoApplyApiVersion:
      type: string
      description: Version of the profileless Auto Apply API contract.
      enum:
        - '2026-07-21'
      example: '2026-07-21'
    ApiRateLimitError:
      type: object
      description: API-key request-window rejection returned by rate-limit middleware.
      required:
        - error
        - detail
        - group
        - retry_after_seconds
      properties:
        error:
          type: string
          example: Rate limit exceeded
        detail:
          type: string
        group:
          type: string
          example: AutoApply
        retry_after_seconds:
          type: integer
          minimum: 0
          nullable: true
    JobCompanyDto:
      type: object
      required:
        - id
        - name
        - website
        - logo_url
        - summary
        - industries
        - categories
        - linkedin_url
        - crunchbase_url
        - details_url
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        website:
          type: string
          nullable: true
        logo_url:
          type: string
          nullable: true
        summary:
          type: string
          nullable: true
        industries:
          type: array
          items:
            type: string
          description: Industry tags describing what the company does.
        categories:
          type: array
          items:
            type: string
          description: Business-model bucket tags (b2b / b2c / saas / service-provider).
        linkedin_url:
          type: string
          nullable: true
        crunchbase_url:
          type: string
          nullable: true
        details_url:
          type: string
          nullable: true
          description: >
            Direct Jobo API URL to the full company profile endpoint

            (`GET https://connect.jobo.world/api/companies/{id}`).

            RapidAPI consumers should rebuild `/api/companies/{id}` on their

            marketplace gateway instead of following this URL with a RapidAPI
            key.
    JobLocationDto:
      type: object
      required:
        - location
        - city
        - region
        - country
        - latitude
        - longitude
      properties:
        location:
          type: string
          nullable: true
        city:
          type: string
          nullable: true
        region:
          type: string
          nullable: true
        country:
          type: string
          nullable: true
        latitude:
          type: number
          format: double
          nullable: true
        longitude:
          type: number
          format: double
          nullable: true
    JobCompensationDto:
      type: object
      required:
        - min
        - max
        - currency
        - period
      properties:
        min:
          type: number
          format: decimal
          nullable: true
        max:
          type: number
          format: decimal
          nullable: true
        currency:
          type: string
          nullable: true
        period:
          type: string
          nullable: true
          enum:
            - hourly
            - daily
            - weekly
            - monthly
            - yearly
            - per-diem
    JobQualificationsDto:
      type: object
      required:
        - must_have
        - preferred
      properties:
        must_have:
          $ref: '#/components/schemas/QualificationBucketDto'
        preferred:
          $ref: '#/components/schemas/QualificationBucketDto'
    QualificationBucketDto:
      type: object
      required:
        - education
        - certifications
        - skills
      properties:
        education:
          type: array
          items:
            type: string
        certifications:
          type: array
          items:
            type: string
        skills:
          type: array
          items:
            $ref: '#/components/schemas/QualificationSkillDto'
    QualificationSkillDto:
      type: object
      required:
        - name
        - type
      properties:
        name:
          type: string
        type:
          type: string
          default: hard
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
    TooManyRequests:
      description: Rate limit exceeded.
      headers:
        Retry-After:
          description: Seconds to wait before retrying.
          schema:
            type: integer
            minimum: 0
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
        application/json:
          schema:
            $ref: '#/components/schemas/ApiRateLimitError'
    ServerError:
      description: Unexpected server error.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: API key provided by Jobo

````