Skip to main content
POST
/
api
/
jobs
/
search
Search jobs via structured request body
curl --request POST \
  --url https://connect.jobo.world/api/jobs/search \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "queries": [
    "<string>"
  ],
  "locations": [
    "<string>"
  ],
  "skills": {
    "include": [
      "<string>"
    ],
    "exclude": [
      "<string>"
    ]
  },
  "companies": {
    "include": [
      "<string>"
    ],
    "exclude": [
      "<string>"
    ]
  },
  "work_models": [],
  "employment_types": [
    "<string>"
  ],
  "experience_levels": [
    "<string>"
  ],
  "salary_usd": {
    "min": 123,
    "max": 123
  },
  "posted_after": "2023-11-07T05:31:56Z",
  "page": 1,
  "page_size": 25
}
'
{
  "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>"
        ],
        "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": "<string>",
      "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
    }
  ],
  "total": 123,
  "page": 123,
  "page_size": 123,
  "total_pages": 123,
  "facets": {}
}

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.

Authorizations

X-Api-Key
string
header
required

API key provided by Jobo

Body

application/json
queries
string[] | null

Free-text search queries

locations
string[] | null

Location strings to filter by (geocoded automatically)

skills
object

Include/exclude skills filter

companies
object

Include/exclude companies filter

work_models
enum<string>[] | null

Filter by work model: remote, hybrid, onsite

Available options:
remote,
hybrid,
onsite
employment_types
string[] | null

Filter by employment type: full-time, part-time, contract, internship, freelance, temporary

experience_levels
string[] | null

Filter by experience level. Canonical values: intern, entry, mid, senior, lead, executive. Values are normalized through a synonym dictionary (junior → entry, sr/staff/principal → senior, manager → lead, director/vp/c-level → executive, etc.).

salary_usd
object

Salary range filter in USD (annual)

posted_after
string<date-time> | null

Only return jobs posted after this date

page
integer
default:1
page_size
integer
default:25

Response

Paginated list of matching jobs with optional facets

jobs
object[]
total
integer<int64>
page
integer
page_size
integer
total_pages
integer
facets
object