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

# Search jobs via query parameters



## OpenAPI

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

    real-time feeds, automated job applications, and geocoding services.
  version: 1.0.0
  contact:
    name: Jobo Support
    url: https://jobo.world
    email: support@jobo.world
servers:
  - url: https://connect.jobo.world
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Jobs Search
    description: Search and retrieve job listings
  - name: Jobs Feed
    description: Bulk job feeds and expiration tracking
  - name: Career Sites Feed
    description: Bulk feed of newly discovered career sites with enriched company profiles
  - name: Companies
    description: Company profiles and company-scoped job listings
  - name: Auto Apply
    description: Automated job application sessions
  - name: Auto Apply Profiles
    description: Manage applicant profiles for auto-apply
  - name: Locations
    description: Geocoding and location services
paths:
  /api/jobs:
    get:
      tags:
        - Jobs Search
      summary: Search jobs via query parameters
      operationId: searchJobsGet
      parameters:
        - name: q
          in: query
          schema:
            type: string
          description: >-
            Free-text search query. By default it matches broadly against the
            job title, company name, popular skills, and summary with typo
            tolerance. Wrap the value in double quotes (e.g. `q="Quantitative
            Developer"`) for an exact, contiguous phrase match restricted to the
            job title only.
        - name: location
          in: query
          schema:
            type: string
          description: Location filter (city, region, or country)
        - name: sources
          in: query
          schema:
            type: string
          description: Comma-separated source identifiers
        - name: work_model
          in: query
          schema:
            type: string
          description: Comma-separated work models (remote, hybrid, onsite)
        - name: employment_type
          in: query
          schema:
            type: string
          description: >-
            Comma-separated employment types (full-time, part-time, contract,
            internship, freelance, temporary)
        - name: experience_level
          in: query
          schema:
            type: string
          description: >
            Comma-separated experience levels. Canonical values: `intern`,
            `entry`,

            `mid`, `senior`, `lead`, `executive`. Common synonyms (junior, sr,

            staff, principal, manager, director, vp, c-level, etc.) are also

            accepted and normalized server-side.
        - name: posted_after
          in: query
          schema:
            type: string
            format: date-time
          description: >-
            Only return jobs whose employer posting date is on or after this
            date
        - name: posted_before
          in: query
          schema:
            type: string
            format: date-time
          description: >-
            Only return jobs whose employer posting date is on or before this
            date
        - name: min_salary_usd
          in: query
          schema:
            type: integer
          description: Minimum annual salary in USD
        - name: max_salary_usd
          in: query
          schema:
            type: integer
          description: Maximum annual salary in USD
        - name: skills
          in: query
          schema:
            type: string
          description: Comma-separated skill names
        - name: page
          in: query
          schema:
            type: integer
            default: 1
            minimum: 1
          description: Page number (1-indexed)
        - name: page_size
          in: query
          schema:
            type: integer
            default: 25
            minimum: 1
            maximum: 100
          description: Number of results per page (max 100)
        - name: include_fields
          in: query
          schema:
            type: string
          description: >
            Comma-separated list of the heavy, non-core fields to include:

            `description`, `summary`, `qualifications`, `responsibilities`,

            `benefits`. **Omit** for the full job (every field, the default).

            Pass a subset to keep only those non-core fields alongside the

            always-present core fields (id, title, company, locations,

            compensation, dates, …). Pass an **empty value**
            (`?include_fields=`)

            for core fields only. Unknown names are ignored; excluded non-core

            fields come back empty (`""` / `[]`).
      responses:
        '200':
          description: Paginated list of matching jobs
          headers:
            X-Total-Count:
              schema:
                type: integer
                format: int64
              description: Total number of matching jobs across all pages.
            X-Total-Pages:
              schema:
                type: integer
              description: Total number of pages available.
            X-Page:
              schema:
                type: integer
              description: Current page number.
            X-Page-Size:
              schema:
                type: integer
              description: Page size used for this request.
            X-Credits-Deducted:
              schema:
                type: integer
              description: >-
                Credits deducted for the delivered search results. Omitted when
                no wallet debit occurs.
            X-Credits-Balance:
              schema:
                type: integer
              description: >-
                Remaining credit balance after the deduction. Omitted when no
                credits were deducted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobSearchResponse'
        '400':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
components:
  schemas:
    JobSearchResponse:
      type: object
      properties:
        jobs:
          type: array
          items:
            $ref: '#/components/schemas/JobDto'
        total:
          type: integer
          format: int64
        page:
          type: integer
        page_size:
          type: integer
        total_pages:
          type: integer
        facets:
          type: object
          additionalProperties:
            type: array
            items:
              $ref: '#/components/schemas/JobFacetDto'
    ProblemDetails:
      type: object
      description: RFC 7807 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
    JobDto:
      type: object
      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:
          oneOf:
            - $ref: '#/components/schemas/JobCompensationDto'
          nullable: true
        employment_type:
          type: string
          nullable: true
          enum:
            - Full-time
            - Part-time
            - Contract
            - Internship
            - Freelance
            - Temporary
            - null
        workplace_type:
          type: string
          nullable: true
          enum:
            - Remote
            - Hybrid
            - On-site
            - null
        experience_level:
          type: string
          nullable: true
          enum:
            - Intern
            - Entry Level
            - Mid Level
            - Senior
            - Lead
            - Executive
            - null
        source:
          type: string
        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
    JobFacetDto:
      type: object
      properties:
        key:
          type: string
        count:
          type: integer
          format: int64
    JobCompanyDto:
      type: object
      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 (typically 1-3) 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: |
            Public URL to the full company profile endpoint
            (`GET https://connect.jobo.world/api/companies/{id}`).
            Null when `id` is empty.
    JobLocationDto:
      type: object
      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
      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
            - null
    JobQualificationsDto:
      type: object
      properties:
        must_have:
          $ref: '#/components/schemas/QualificationBucketDto'
        preferred:
          $ref: '#/components/schemas/QualificationBucketDto'
    QualificationBucketDto:
      type: object
      properties:
        education:
          type: array
          items:
            type: string
        certifications:
          type: array
          items:
            type: string
        skills:
          type: array
          items:
            $ref: '#/components/schemas/QualificationSkillDto'
    QualificationSkillDto:
      type: object
      properties:
        name:
          type: string
        type:
          type: string
          default: hard
  responses:
    Unauthorized:
      description: Missing or invalid API key
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: API key provided by Jobo

````