Skip to main content
GET
Get Jobs
Use this endpoint when you need to mirror your job board into another system, power a search page, or run scheduled exports.

Common Filters

Match against the job title, description, and company name.
job_types
string
Comma-separated job types such as full-time,contract.
locations
string
Comma-separated locations such as Remote,New York.
categories
string
Comma-separated category UUIDs.
is_remote
boolean
Set to true to return only remote jobs.
posted_within
string
Only return jobs posted within a recent window. One of 24h, 7d, 14d, 30d, 90d. Use 7d for “this week”.
date_from
string
Only return jobs posted on or after this date (ISO 8601, e.g. 2026-07-01 or a full timestamp). Combine with date_to for a custom range.
date_to
string
Only return jobs posted on or before this date (ISO 8601).
page
number
default:"1"
Page number.
per_page
number
default:"20"
Number of records per page, up to 100.

Examples

List the latest jobs

cURL

Search for a phrase

cURL

Fetch only remote full-time jobs

cURL

Combine search, location, and pagination

cURL

Jobs posted this week

cURL

Jobs posted in a custom date range

cURL

JavaScript example

Python example

Response Shape

data
array
required
Matching jobs. Each job includes the full public url, salary, category, dates, and the fields below.
data[].url
string
The full, shareable public URL to the job on your live board (uses your active custom domain when you have one, otherwise your *.kardow.com subdomain). Send people here.
data[].slug
string
The URL path portion only, without the domain.
data[].salary_min
number
Minimum salary, or null. Also salary_max, salary_currency (ISO code), and salary_period (hourly, daily, weekly, monthly, yearly).
data[].posted_at
string
When the job was posted (ISO 8601). Alias of created_at. See also updated_at and expires_at.
data[].how_to_apply
string
The application destination (URL, email, or phone), with how_to_apply_method describing which it is. This is where a candidate applies, and is not the same as url (the public listing page).
meta.board_url
string
The base public URL of your job board.
meta.pagination
object
required
Pagination summary with the current page, page size, total items, total pages, and whether another page is available.
meta.filters
object
required
Echoes the filters Kardow applied to the query, including any date filter.

Example response

Authorizations

x-api-key
string
header
required

API key for authentication. Get yours from Settings > API Keys in the Kardow dashboard.

Query Parameters

page
integer
default:1
Required range: x >= 1
per_page
integer
default:20
Required range: 1 <= x <= 100
job_types
string

Comma-separated job types.

Example:

"full-time,contract"

locations
string

Comma-separated locations.

Example:

"Remote,New York"

categories
string

Comma-separated category UUIDs.

Example:

"123e4567-e89b-12d3-a456-426614174000,123e4567-e89b-12d3-a456-426614174001"

is_remote
boolean
posted_within
enum<string>

Only jobs posted within a recent window. Use 7d for "this week".

Available options:
24h,
7d,
14d,
30d,
90d
date_from
string

Only jobs posted on or after this ISO 8601 date. Combine with date_to for a custom range.

Example:

"2026-07-01"

date_to
string

Only jobs posted on or before this ISO 8601 date.

Example:

"2026-07-31"

Response

Success

data
object[]
required
meta
object
required