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 | A job title, skill or keyword, matched as whole words in the title, skill tags or company name ("go" finds Go jobs, not Google); every value of q and skills must match, at most 10 in all (more is a 400 error) |
| location | array | Location filter (city, state, country, or "remote") |
| company | string | Filter by specific company |
| skills | array | Required skills or other terms, each matched like q; a job must match every one (at most 10 values, q included) |
| 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 or other terms, each matched like q; a job must match every one (at most 10 values, q included; 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) |
| q | string | Optional job title, skill or keyword, matched like q on /jobs/search |
| location | array | Optional location filter |
| skills | array | Optional skills or other terms, each matched like q; a job must match every one (at most 10 values, q included) |
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.