A comprehensive REST API for job search functionality, designed for website builders, job board operators, mobile app developers, and job seekers.
https://jobsearch.greenrobot.com/api/v1
JSON
Free
$29.99/month
API requests are rate limited to ensure fair usage and system stability.
| Plan | Monthly Calls | Per Minute | Per Hour |
|---|---|---|---|
| Trial | 1,000 | 60 | 1,000 |
| Premium | 50,000 | 120 | 5,000 |
Monthly usage is measured in tokens. Most endpoints cost 1 token per request. Some operations consume more:
| Operation | Token Cost | Notes |
|---|---|---|
| GET /jobs/search | 1 | Standard search |
| GET /jobs/{job_id} | 1 | Job details |
| GET /jobs/recent | 1 | Recent jobs window |
| POST /jobs/bulk-download | Varies (500–10,000) | Full or daily delta export; returns a 24h signed download_url; credits deducted on generation |
Bulk download links expire in 24 hours. Token charges apply at generation time even if the file is not downloaded.
Rate limit information is included in response headers:
X-RateLimit-Limit: Request limit for the current windowX-RateLimit-Remaining: Remaining requests in current windowX-RateLimit-Reset: Time when rate limit resets (Unix timestamp)Search for jobs with comprehensive filtering options.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search query for job title, company, or keywords |
| location | array | Location filter (city, state, country, or "remote") |
| company | string | Filter by specific company |
| skills | array | Required skills/technologies |
| job_type | array | Job type filter (full_time, part_time, contract, internship, remote) |
| page | integer | Page number for pagination (default: 1) |
| per_page | integer | Results per page (1-100, default: 20) |
Get detailed information for a specific job posting.
Prepare a gzipped JSONL export of all jobs (full) or a daily update (delta). Returns a signed download URL valid for 24 hours. Credits are deducted when generated, even if not downloaded.
| Field | Type | Description |
|---|---|---|
| mode | string | full (default) or delta |
| days | integer | When mode=delta, number of days back if since not provided (default: 1) |
| q | string | Optional search query |
| location | array | Optional location filter (also supports location[]) |
| skills | array | Optional skills filter (also supports skills[]) |
| since | string | ISO datetime used when mode=delta, e.g., 2025-11-04T00:00:00Z |
Get jobs posted in the last N days with pagination support.
Requires: Premium subscription
| Parameter | Type | Description |
|---|---|---|
| days | integer | Number of days to look back (1-30, default: 7) |
| page | integer | Page number (default: 1) |
| per_page | integer | Results per page (1-100, default: 20) |
| location | array | Optional location filter |
| skills | array | Optional skills filter |
curl -H "X-API-Key: your_api_key" \
"https://jobsearch.greenrobot.com/api/v1/jobs/search?skills[]=Python&location[]=San Francisco"curl -H "X-API-Key: your_api_key" \
"https://jobsearch.greenrobot.com/api/v1/jobs/12345"{
"data": {
"jobs": [
{
"id": 12345,
"title": "Senior Software Engineer",
"company": "Tech Corp",
"location": "San Francisco, CA",
"salary_range": "$120,000 - $180,000",
"date_posted": "2024-01-15",
"source": "LinkedIn",
"job_type": ["full_time", "remote"],
"skills": ["Python", "React", "AWS"],
"url": "https://company.com/jobs/12345"
}
],
"pagination": {
"current_page": 1,
"per_page": 20,
"total_pages": 63,
"total_count": 1247,
"has_next": true,
"has_previous": false
}
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"response_time_ms": 45.2,
"api_version": "1.0.0"
}
}Test all API endpoints directly from this page with full parameter support:
Official SDKs and community libraries are coming soon. In the meantime, you can use any HTTP client to interact with the API. See the examples above for sample requests using cURL.