Download OpenAPI specification:Download
An API for searching Joby.ai's entire jobs and companies database.
Joby.ai scans company career pages directly to compile the most up-to-date database of jobs and companies hiring on the internet. We then leverage LLMs to build a powerful search engine that uncovers hidden jobs and filters out expired roles from all over the world. Our mission is to build the last job search engine you'll ever use - every job, every company, actually hiring now on the internet.
Build your product or tool with our data of the most up-to-date jobs and companies hiring on the internet.
We've published a Postman Collection to make it easy to explore and test our API. You can find it here.
If you're interested in using our API, please fill out this short questionnaire or contact us at hello@joby.ai. We'll be in touch to discuss your use case and provide an API key.
All API requests require authentication using an API key. Include your API key in the X-API-KEY
header of each request.
curl -X GET 'https://isjquipyl4.execute-api.us-east-1.amazonaws.com/beta/jobs?and=python&location=new%20york&salaryFrom=80000&limit=5' \
-H 'X-API-KEY: your_api_key_here'
If you have any questions, issues, or feature requests, please email us at hello@joby.ai. We are here to help you succeed with the Joby.ai API.
Happy job searching! 🚀
Search for jobs by keywords, location, and other parameters.
and | Array of strings Example: and=ai&and=computer vision Words and phrases, all of which must appear in the job description or title. |
or | Array of strings Example: or=python&or=java Words and phrases, at least one of which must appear in the job description or title. |
not | Array of strings Example: not=senior¬=manager Words and phrases, none of which must appear in the job description or title. |
title | Array of strings Example: title=engineer&title=developer Words and phrases, at least one of which must appear in the job title. |
company | Array of strings Example: company=google&company=facebook Company names that posted the job. |
location | Array of strings Example: location=germany&location=remote Words and phrases, at least one of which must appear in the job location. |
yearsFrom | integer >= 0 Example: yearsFrom=3 Minimum number of required years of experience to get results for. |
yearsTo | integer >= 0 Example: yearsTo=5 Maximum number of required years of experience to get results for. |
salaryFrom | number >= 0 Example: salaryFrom=80000 Minimum salary amount to get results for. |
salaryTo | number >= 0 Example: salaryTo=120000 Maximum salary amount to get results for. |
salaryCurrency | string Example: salaryCurrency=USD Currency of the salary. |
salaryPeriod | string Example: salaryPeriod=year Salary period. |
visa | boolean Example: visa=true Whether the job sponsors visa. |
days | integer >= 1 Example: days=7 Maximum number of days since the job was posted. |
limit | integer [ 1 .. 100 ] Default: 10 Number of jobs to return. |
offset | integer >= 0 Default: 0 Number of jobs to skip. |
const axios = require('axios') await axios.get("https://api.joby.ai/v0/jobs", { params: { and: ['node', 'react'], location: ['san francisco', 'bay area'], days: 30, limit: 5 }, headers: { 'x-api-key': 'YOUR_API_KEY' } })
[- {
- "_id": "65314d5c61fa344dd181d36b",
- "company_name": "Insurance Company",
- "job_title": "Finance Manager",
- "country": [
- "United States",
- "Canada",
- "EMEA",
- "Africa"
], - "city": "New York",
- "us_state": [
- "New York",
- "Texas"
], - "job_category": [
- "Legal Jobs",
- "Finance"
], - "job_type": [
- "Full Time",
- "Contract"
], - "location_type": [
- "In-Person",
- "Hybrid"
], - "description": "'<div>\\n<p>Job description</p>\\n</div>'",
- "salary_range": {
- "min": 100000,
- "max": 200000,
- "period": "year",
- "currency": "USD"
}, - "visa_sponsored": false,
- "requirements_summary": "5+ years of experience in finance.",
- "yoe_range": {
- "min": 5,
- "max": 8
}, - "job_board": "Greenhouse",
- "company_data": {
- "description_summary": "string",
- "size_range": {
- "min": 1001,
- "max": 5000
}, - "industries": [
- "Finance",
- "Real Estate"
], - "subindustries": [
- "Insurance",
- "Banking"
]
}, - "date_posted": "2023-10-18"
}
]