Get Jobs with the API

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.

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.

Pagination Parameters

Parameter	Type	Description	Default	Max
page	number	Page number to retrieve	1	-
per_page	number	Number of items per page	20	100

Search & Filter Parameters

Parameter	Type	Description
search	string	Search term for jobs
categories[]	UUID[]	Filter by category IDs
job_types[]	string[]	Filter by job types
locations[]	string[]	Filter by locations
is_remote	boolean	Filter for remote jobs

Available Job Types

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

Basic Request

bash curl -X GET ‘https://api.kardow.com/jobs’
-H ‘X-API-Key: your_api_key’

With Pagination

bash curl -X GET ‘https://api.kardow.com/jobs?page=2&per_page=10’
-H ‘X-API-Key: your_api_key

With Search and Filters

bash 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’

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 Query	Matches
developer	”Senior Developer”, “JavaScript Developer”, “Developer Relations”
remote developer	Jobs containing both “remote” and “developer”
senior engineer	”Senior Software Engineer”, “Senior Systems Engineer”

• 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: bash curl -X GET ‘https://api.kardow.com/jobs?page=2&per_page=10’
-H ‘X-API-Key: your_api_key’

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

Need help? Contact our support team:

• Documentation: https://kardow.com/help
• Feature Requests: https://kardow.userjot.com
• API Status: https://kardow.openstatus.dev