Skip to main content
GET
https://connect.jobo.world
/
api
/
jobs
curl -G "https://connect.jobo.world/api/jobs" \
  -H "X-Api-Key: YOUR_API_KEY" \
  --data-urlencode "q=software engineer" \
  --data-urlencode "location=San Francisco" \
  --data-urlencode "work_model=remote,hybrid" \
  --data-urlencode "employment_type=full-time" \
  --data-urlencode "experience_level=senior level,lead/staff" \
  --data-urlencode "skills=python,kubernetes" \
  --data-urlencode "min_salary_usd=150000" \
  --data-urlencode "sources=greenhouse,lever" \
  --data-urlencode "page_size=10"
{
  "jobs": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Senior Software Engineer",
      "normalized_title": "Software Engineer",
      "company": {
        "id": "b5e6f7a8-1234-5678-9abc-def012345678",
        "name": "Acme Corp",
        "website": "https://acme.com",
        "logo_url": "https://logo.clearbit.com/acme.com",
        "summary": "Leading technology company specializing in cloud infrastructure"
      },
      "description": "<p>We are looking for a <strong>Senior Software Engineer</strong> to join our platform team...</p>",
      "summary": "Senior backend role focusing on distributed systems and API platform development",
      "listing_url": "https://boards.greenhouse.io/acme/jobs/123",
      "apply_url": "https://boards.greenhouse.io/acme/jobs/123/application",
      "locations": [
        {
          "location": "San Francisco, CA",
          "city": "San Francisco",
          "region": "California",
          "country": "United States",
          "latitude": 37.7749,
          "longitude": -122.4194
        }
      ],
      "compensation": {
        "min": 180000,
        "max": 240000,
        "currency": "USD",
        "period": "yearly"
      },
      "employment_type": "Full-time",
      "workplace_type": "Remote",
      "experience_level": "Senior Level",
      "source": "greenhouse",
      "created_at": "2026-02-28T12:00:00Z",
      "updated_at": "2026-03-01T08:30:00Z",
      "date_posted": "2026-02-28T00:00:00Z",
      "valid_through": "2026-04-28T00:00:00Z",
      "is_remote": true,
      "qualifications": {
        "must_have": {
          "education": ["Bachelor's in Computer Science or equivalent"],
          "certifications": [],
          "skills": [
            { "name": "Python", "type": "hard" },
            { "name": "Kubernetes", "type": "hard" },
            { "name": "Distributed Systems", "type": "hard" }
          ]
        },
        "preferred": {
          "education": [],
          "certifications": ["AWS Solutions Architect"],
          "skills": [
            { "name": "Terraform", "type": "hard" },
            { "name": "Go", "type": "hard" },
            { "name": "Leadership", "type": "soft" }
          ]
        }
      },
      "responsibilities": [
        "Design and build scalable APIs serving millions of requests per day",
        "Lead technical design reviews and mentor junior engineers",
        "Improve system reliability and observability across the platform"
      ],
      "benefits": [
        "Health insurance",
        "401(k) matching",
        "Unlimited PTO",
        "Equity compensation",
        "Home office stipend"
      ],
      "is_work_auth_required": null,
      "is_h1b_sponsor": true,
      "is_clearance_required": false
    }
  ],
  "total": 12847,
  "page": 1,
  "page_size": 10,
  "total_pages": 1285,
  "facets": {
    "source": [
      { "key": "greenhouse", "count": 4521 },
      { "key": "lever", "count": 3102 },
      { "key": "workday", "count": 2087 }
    ],
    "workplace_type": [
      { "key": "Remote", "count": 6432 },
      { "key": "Hybrid", "count": 4210 },
      { "key": "Onsite", "count": 2205 }
    ],
    "employment_type": [
      { "key": "Full-time", "count": 11203 },
      { "key": "Contract", "count": 1102 },
      { "key": "Part-time", "count": 542 }
    ],
    "experience_level": [
      { "key": "Senior Level", "count": 5210 },
      { "key": "Mid Level", "count": 4102 },
      { "key": "Entry Level", "count": 2130 },
      { "key": "Lead/Staff", "count": 1405 }
    ]
  }
}

Query Parameters

q
string
Free-text search across job titles, company names, and descriptions.
location
string
Location filter. Accepts city names, states, countries, or regions (e.g., "San Francisco", "California", "United States"). Geocoded server-side to match jobs within the area.
sources
string
Comma-separated ATS source IDs to filter by platform.Examples: greenhouse, lever, workday, ashby, bamboohr, icims, smartrecruiters, teamtailor, workable, rippling, personio, taleo, successfactors, paylocity.
sources=greenhouse,lever,workday
work_model
string
Comma-separated work model filter. Case-insensitive.Accepted values: remote, hybrid, onsite.
work_model=remote,hybrid
employment_type
string
Comma-separated employment type filter. Case-insensitive.Accepted values: full-time, part-time, contract, internship, temporary.
employment_type=full-time,contract
experience_level
string
Comma-separated experience level filter. Case-insensitive.Accepted values: entry level, mid level, senior level, lead/staff, principal, director, vp, executive.
experience_level=senior level,lead/staff
posted_after
string
ISO 8601 UTC datetime. Only return jobs posted after this date.
posted_after=2026-02-01T00:00:00Z
min_salary_usd
integer
Minimum annual USD salary filter. Jobs with compensation below this value are excluded.
max_salary_usd
integer
Maximum annual USD salary filter. Jobs with compensation above this value are excluded.
skills
string
Comma-separated skills to filter on.
skills=python,kubernetes,react
page
integer
default:"1"
Page number (1-indexed).
page_size
integer
default:"25"
Results per page (1–100).

Response Body

jobs
JobDto[]
Array of matching job objects. See Job Object for the full schema.
total
integer
Total number of matching jobs across all pages.
page
integer
Current page number.
page_size
integer
Number of results per page.
total_pages
integer
Total number of pages available.
facets
object
Aggregation counts for filterable fields. Each key is a field name, and the value is an array of { "key": "value", "count": number } objects representing the distribution of values for that field across the matching results.Facets allow you to build dynamic filter UIs showing available options and their counts. For example, facets.source tells you how many matching jobs come from each ATS platform.

Response Headers

The following headers are included in every successful response:
HeaderTypeDescription
X-Total-CountintegerTotal number of matching jobs
X-Total-PagesintegerTotal number of pages
X-PageintegerCurrent page number
X-Page-SizeintegerNumber of results per page

Job Object

Each object in the jobs array has the following shape:
id
string
Unique job identifier (UUID).
title
string
Original job title as posted.
normalized_title
string | null
Standardized job title (e.g., "Software Engineer"). May be null if normalization has not been applied.
company
object
Company information.
description
string
Full job description in HTML format.
summary
string | null
AI-generated short summary of the job posting.
listing_url
string
URL of the original job listing on the ATS platform.
apply_url
string
Direct URL to the application page.
locations
array
Array of location objects associated with the job.
compensation
object | null
Compensation details. null if no compensation data is available.
employment_type
string | null
Employment type. One of: "Full-time", "Part-time", "Contract", "Internship", "Temporary".
workplace_type
string | null
Workplace / work model. One of: "Remote", "Hybrid", "Onsite".
experience_level
string | null
Required experience level. One of: "Entry Level", "Mid Level", "Senior Level", "Lead/Staff", "Principal", "Director", "VP", "Executive".
source
string
ATS platform the job was sourced from (e.g., "greenhouse", "lever", "workday").
created_at
string
ISO 8601 datetime when the job was first ingested.
updated_at
string
ISO 8601 datetime when the job was last updated.
date_posted
string | null
ISO 8601 datetime when the job was originally posted.
valid_through
string | null
ISO 8601 datetime when the job listing expires.
is_remote
boolean
Whether the job supports remote work.
qualifications
object
Structured qualification requirements.
responsibilities
string[]
List of job responsibilities extracted from the posting.
benefits
string[]
List of benefits mentioned in the posting.
is_work_auth_required
boolean | null
Whether work authorization is required. null if not specified.
is_h1b_sponsor
boolean | null
Whether the employer sponsors H-1B visas. null if not specified.
is_clearance_required
boolean | null
Whether a security clearance is required. null if not specified.
curl -G "https://connect.jobo.world/api/jobs" \
  -H "X-Api-Key: YOUR_API_KEY" \
  --data-urlencode "q=software engineer" \
  --data-urlencode "location=San Francisco" \
  --data-urlencode "work_model=remote,hybrid" \
  --data-urlencode "employment_type=full-time" \
  --data-urlencode "experience_level=senior level,lead/staff" \
  --data-urlencode "skills=python,kubernetes" \
  --data-urlencode "min_salary_usd=150000" \
  --data-urlencode "sources=greenhouse,lever" \
  --data-urlencode "page_size=10"
{
  "jobs": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Senior Software Engineer",
      "normalized_title": "Software Engineer",
      "company": {
        "id": "b5e6f7a8-1234-5678-9abc-def012345678",
        "name": "Acme Corp",
        "website": "https://acme.com",
        "logo_url": "https://logo.clearbit.com/acme.com",
        "summary": "Leading technology company specializing in cloud infrastructure"
      },
      "description": "<p>We are looking for a <strong>Senior Software Engineer</strong> to join our platform team...</p>",
      "summary": "Senior backend role focusing on distributed systems and API platform development",
      "listing_url": "https://boards.greenhouse.io/acme/jobs/123",
      "apply_url": "https://boards.greenhouse.io/acme/jobs/123/application",
      "locations": [
        {
          "location": "San Francisco, CA",
          "city": "San Francisco",
          "region": "California",
          "country": "United States",
          "latitude": 37.7749,
          "longitude": -122.4194
        }
      ],
      "compensation": {
        "min": 180000,
        "max": 240000,
        "currency": "USD",
        "period": "yearly"
      },
      "employment_type": "Full-time",
      "workplace_type": "Remote",
      "experience_level": "Senior Level",
      "source": "greenhouse",
      "created_at": "2026-02-28T12:00:00Z",
      "updated_at": "2026-03-01T08:30:00Z",
      "date_posted": "2026-02-28T00:00:00Z",
      "valid_through": "2026-04-28T00:00:00Z",
      "is_remote": true,
      "qualifications": {
        "must_have": {
          "education": ["Bachelor's in Computer Science or equivalent"],
          "certifications": [],
          "skills": [
            { "name": "Python", "type": "hard" },
            { "name": "Kubernetes", "type": "hard" },
            { "name": "Distributed Systems", "type": "hard" }
          ]
        },
        "preferred": {
          "education": [],
          "certifications": ["AWS Solutions Architect"],
          "skills": [
            { "name": "Terraform", "type": "hard" },
            { "name": "Go", "type": "hard" },
            { "name": "Leadership", "type": "soft" }
          ]
        }
      },
      "responsibilities": [
        "Design and build scalable APIs serving millions of requests per day",
        "Lead technical design reviews and mentor junior engineers",
        "Improve system reliability and observability across the platform"
      ],
      "benefits": [
        "Health insurance",
        "401(k) matching",
        "Unlimited PTO",
        "Equity compensation",
        "Home office stipend"
      ],
      "is_work_auth_required": null,
      "is_h1b_sponsor": true,
      "is_clearance_required": false
    }
  ],
  "total": 12847,
  "page": 1,
  "page_size": 10,
  "total_pages": 1285,
  "facets": {
    "source": [
      { "key": "greenhouse", "count": 4521 },
      { "key": "lever", "count": 3102 },
      { "key": "workday", "count": 2087 }
    ],
    "workplace_type": [
      { "key": "Remote", "count": 6432 },
      { "key": "Hybrid", "count": 4210 },
      { "key": "Onsite", "count": 2205 }
    ],
    "employment_type": [
      { "key": "Full-time", "count": 11203 },
      { "key": "Contract", "count": 1102 },
      { "key": "Part-time", "count": 542 }
    ],
    "experience_level": [
      { "key": "Senior Level", "count": 5210 },
      { "key": "Mid Level", "count": 4102 },
      { "key": "Entry Level", "count": 2130 },
      { "key": "Lead/Staff", "count": 1405 }
    ]
  }
}