Skip to main content

​
Prerequisites

Before you begin, make sure you have:

Jobo Enterprise Account

Sign up for free if you don’t have one yet.

API Key

Navigate to Settings → API Keys in the dashboard to generate your key.
Store your API key in an environment variable for easy use: bash export JOBO_API_KEY="your_api_key_here" # macOS/Linux set JOBO_API_KEY=your_api_key_here # Windows CMD $env:JOBO_API_KEY="your_api_key_here" # PowerShell

​
Get Started in 3 Steps

1

Install an SDK (optional)

Pick your language — or skip this step and use raw HTTP with cURL.
pip install jobo-enterprise
SDKs handle authentication, pagination, retries, and type safety for you. See the Client Libraries page for full details.
2

Make Your First Request

Search for software engineer jobs and retrieve five results:
curl "https://connect.jobo.world/api/jobs?q=software+engineer&page_size=5" \
  -H "X-Api-Key: $JOBO_API_KEY"
3

Parse the Response

The API returns a JSON object with a jobs array and pagination metadata:
{
  "jobs": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Senior Software Engineer",
      "company": {
        "name": "Acme Corp",
        "website": "https://acme.com",
        "logo_url": "https://logo.clearbit.com/acme.com"
      },
      "locations": [
        {
          "city": "San Francisco",
          "region": "California",
          "country": "United States"
        }
      ],
      "compensation": {
        "min": 150000,
        "max": 200000,
        "currency": "USD",
        "period": "year"
      },
      "is_remote": true,
      "source": "greenhouse",
      "date_posted": "2026-02-28T00:00:00Z",
      "apply_url": "https://boards.greenhouse.io/acme/jobs/123456"
    }
  ],
  "total": 12847,
  "page": 1,
  "page_size": 5,
  "total_pages": 2570
}

​
Response Breakdown

Understanding the key fields in the response:
FieldTypeDescription
jobsarrayList of job objects matching your query
jobs[].idstring (UUID)Unique identifier for the job listing
jobs[].titlestringJob title as posted by the employer
jobs[].companyobjectCompany info including name, website, and logo_url
jobs[].locationsarrayStructured locations with city, region, country, and optional lat/lng
jobs[].compensationobjectSalary data with min, max, currency, and period (year/hour/month)
jobs[].is_remotebooleanWhether the position allows remote work
jobs[].sourcestringATS platform the job was scraped from (e.g. greenhouse, lever, workday)
jobs[].date_postedstring (ISO 8601)When the job was first published
jobs[].apply_urlstringDirect link to the original application page
totalintegerTotal number of jobs matching your query
pageintegerCurrent page number (1-indexed)
page_sizeintegerNumber of results per page (max 100)
total_pagesintegerTotal pages available
For the complete job schema including all available fields, see the Job Schema reference.

​
Common First Steps

Once your first request is working, try these common patterns:
Use the q parameter to do full-text search across job titles, descriptions, and company names.
curl "https://connect.jobo.world/api/jobs?q=data+scientist&page_size=10" \
  -H "X-Api-Key: $JOBO_API_KEY"
Pass a location parameter to narrow results to a specific city, state, or country.
curl "https://connect.jobo.world/api/jobs?q=product+manager&location=New+York" \
  -H "X-Api-Key: $JOBO_API_KEY"
Set is_remote=true to return only remote-friendly positions.
curl "https://connect.jobo.world/api/jobs?q=frontend+engineer&is_remote=true" \
  -H "X-Api-Key: $JOBO_API_KEY"
Use page and page_size to iterate through large result sets. SDKs handle this automatically.
# Page 1
curl "https://connect.jobo.world/api/jobs?q=engineer&page=1&page_size=50" \
  -H "X-Api-Key: $JOBO_API_KEY"

# Page 2
curl "https://connect.jobo.world/api/jobs?q=engineer&page=2&page_size=50" \
  -H "X-Api-Key: $JOBO_API_KEY"

​
Next Steps

Search API

Explore all search parameters — keyword, location, date range, ATS source, and more

Advanced Query

Build composable filters with AND/OR logic for complex searches

Jobs Feed

Stream high-volume job data in incremental batches via cursor-based pagination

Auto Apply

Automate job applications with browser-driven form filling

Data Platform

Export to CSV, JSON, or Parquet — or sync directly to your database

Client Libraries

Official SDKs with auto-pagination, retries, and full type safety