Quick Start

Prerequisites

Before you begin, make sure you have:

Jobo Enterprise Account

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

Install an SDK (optional)

Pick your language — or skip this step and use raw HTTP with cURL.

pip install jobo-enterprise

npm install jobo-enterprise

dotnet add package Jobo.Enterprise.Client

SDKs handle authentication, pagination, retries, and type safety for you. See the Client Libraries page for full details.

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"

from jobo_enterprise import JoboClient

client = JoboClient(api_key="YOUR_API_KEY")

results = client.jobs.search(
    q="software engineer",
    page_size=5
)

for job in results.jobs:
    print(f"{job.title} at {job.company.name}")

import { JoboClient } from 'jobo-enterprise';

const client = new JoboClient({ apiKey: 'YOUR_API_KEY' });

const results = await client.jobs.search({
  q: 'software engineer',
  pageSize: 5,
});

results.jobs.forEach(job => {
  console.log(`${job.title} at ${job.company.name}`);
});

using Jobo.Enterprise.Client;

var client = new JoboClient("YOUR_API_KEY");

var results = await client.Jobs.SearchAsync(new SearchRequest
{
    Q = "software engineer",
    PageSize = 5
});

foreach (var job in results.Jobs)
{
    Console.WriteLine($"{job.Title} at {job.Company.Name}");
}

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:

Field	Type	Description
`jobs`	array	List of job objects matching your query
`jobs[].id`	string (UUID)	Unique identifier for the job listing
`jobs[].title`	string	Job title as posted by the employer
`jobs[].company`	object	Company info including `name`, `website`, and `logo_url`
`jobs[].locations`	array	Structured locations with `city`, `region`, `country`, and optional `lat`/`lng`
`jobs[].compensation`	object	Salary data with `min`, `max`, `currency`, and `period` (year/hour/month)
`jobs[].is_remote`	boolean	Whether the position allows remote work
`jobs[].source`	string	ATS platform the job was scraped from (e.g. `greenhouse`, `lever`, `workday`)
`jobs[].date_posted`	string (ISO 8601)	When the job was first published
`jobs[].apply_url`	string	Direct link to the original application page
`total`	integer	Total number of jobs matching your query
`page`	integer	Current page number (1-indexed)
`page_size`	integer	Number of results per page (max 100)
`total_pages`	integer	Total 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:

Search by Keyword

Use the q parameter to do full-text search across job titles, company names, skills, and summaries. Wrap the value in double quotes (q="data scientist") for an exact, title-only phrase match.

curl "https://connect.jobo.world/api/jobs?q=data+scientist&page_size=10" \
  -H "X-Api-Key: $JOBO_API_KEY"

results = client.jobs.search(q="data scientist", page_size=10)

const results = await client.jobs.search({ q: 'data scientist', pageSize: 10 });

var results = await client.Jobs.SearchAsync(new SearchRequest
{
    Q = "data scientist",
    PageSize = 10
});

Filter by Location

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"

results = client.jobs.search(q="product manager", location="New York")

const results = await client.jobs.search({ q: 'product manager', location: 'New York' });

var results = await client.Jobs.SearchAsync(new SearchRequest
{
    Q = "product manager",
    Location = "New York"
});

Filter by Remote

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"

results = client.jobs.search(q="frontend engineer", is_remote=True)

const results = await client.jobs.search({ q: 'frontend engineer', isRemote: true });

var results = await client.Jobs.SearchAsync(new SearchRequest
{
    Q = "frontend engineer",
    IsRemote = true
});

Paginate Through Results

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"

# Manual pagination
page = 1
while True:
    results = client.jobs.search(q="engineer", page=page, page_size=50)
    for job in results.jobs:
        print(job.title)
    if page >= results.total_pages:
        break
    page += 1

# Or use auto-pagination (recommended)
for job in client.jobs.search_iter(q="engineer"):
    print(job.title)

// Manual pagination
let page = 1;
let totalPages = 1;
do {
  const results = await client.jobs.search({ q: 'engineer', page, pageSize: 50 });
  results.jobs.forEach(job => console.log(job.title));
  totalPages = results.totalPages;
  page++;
} while (page <= totalPages);

// Or use auto-pagination (recommended)
for await (const job of client.jobs.searchIter({ q: 'engineer' })) {
  console.log(job.title);
}

// Auto-pagination with IAsyncEnumerable
await foreach (var job in client.Jobs.SearchEnumerableAsync(new SearchRequest
{
    Q = "engineer"
}))
{
    Console.WriteLine(job.Title);
}

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

Getting Started

Resources

Prerequisites

Jobo Enterprise Account

API Key

Get Started in 3 Steps

Response Breakdown

Common First Steps

Next Steps

Search API

Advanced Query

Jobs Feed

Auto Apply

Data Platform

Client Libraries

​Prerequisites

Jobo Enterprise Account

API Key

​Get Started in 3 Steps

​Response Breakdown

​Common First Steps

​Next Steps

Search API

Advanced Query

Jobs Feed

Auto Apply

Data Platform

Client Libraries

Prerequisites

Get Started in 3 Steps

Response Breakdown

Common First Steps

Next Steps