Get Jobs with the API

Learn how to retrieve job listings from your organization using our REST API.

1

Authentication

All requests must include your API key in the headers:

http X-API-Key: your_api_key

You can find your API key in your organization settings.

2

Endpoint

You can find your API key in your organization settings.

http GET https://api.kardow.com/jobs

The endpoint returns a paginated list of jobs from your organization.

3

Query Parameters

Pagination Parameters

ParameterTypeDescriptionDefaultMax
pagenumberPage number to retrieve1-
per_pagenumberNumber of items per page20100

Search & Filter Parameters

ParameterTypeDescription
searchstringSearch term for jobs
categories[]UUID[]Filter by category IDs
job_types[]string[]Filter by job types
locations[]string[]Filter by locations
is_remotebooleanFilter for remote jobs

Available Job Types

  • full-time
  • part-time
  • contract
  • internship
  • temporary

Enhanced Query Parameters Reference

Search & Filter Parameters

Prop Type Default
search
string -
categories[]
UUID[] -
job_types[]
string[] -
locations[]
string[] -
is_remote
boolean -
page
number 1
per_page
number 20
4

Example Requests
/api-examples.sh
Basic Request 
curl -X GET 'https://api.kardow.com/jobs' \
-H 'X-API-Key: your_api_key'
With Pagination 
curl -X GET 'https://api.kardow.com/jobs?page=2&per_page=10' \
-H 'X-API-Key: your_api_key'
With Search and Filters 
curl -X GET 'https://api.kardow.com/jobs?search=developer&job_types[]=full-time&locations[]=New York&is_remote=true' \
-H 'X-API-Key: your_api_key'
JavaScript/Node.js 
const response = await fetch('https://api.kardow.com/jobs', {
headers: {
  'X-API-Key': 'your_api_key'
}
});

const data = await response.json();
console.log(data.jobs);
Python 
import requests

response = requests.get(
  'https://api.kardow.com/jobs',
  headers={'X-API-Key': 'your_api_key'}
)

jobs = response.json()['jobs']
print(jobs)
5

Search Behavior

The search functionality is designed to be intuitive and powerful:

  • Searches across multiple fields:
    • Job title
    • Company name
    • Job description
  • Case-insensitive matching
  • Supports partial word matches
  • Multiple words are treated as AND conditions
  • Results are ranked by relevance

Example Search Queries

Search QueryMatches
developer”Senior Developer”, “JavaScript Developer”, “Developer Relations”
remote developerJobs containing both “remote” and “developer”
senior engineer”Senior Software Engineer”, “Senior Systems Engineer”
6

Pagination Details
  • Pages are 1-indexed (start at 1)
  • Maximum items per page is 100
  • Response includes helpful pagination metadata:
    • total_items: Total number of matching jobs
    • total_pages: Total number of pages available
    • has_more: Whether there are more pages after the current one

Pagination Example

To fetch the second page of results with 10 items per page:

cURL 
curl -X GET 'https://api.kardow.com/jobs?page=2&per_page=10' \
-H 'X-API-Key: your_api_key'
7

Best Practices

  1. Use Pagination

    • Always use pagination for large result sets
    • Keep per_page reasonable (10-50 items)

  2. Optimize Search Queries

    • Use specific search terms
    • Combine with filters for better results

  3. Handle Errors

    • Implement proper error handling
    • Check response status codes
    • Log error messages for debugging

  4. Cache Responses

    • Cache responses when appropriate
    • Implement cache invalidation strategies

  5. Rate Limiting

    • Implement exponential backoff
    • Monitor rate limit headers
    • Space out requests appropriately
8

Support

Need help? Contact our support team: