logo
API docs by Redocly

Joby.ai Search API (v0)

Download OpenAPI specification:Download

E-mail: hello@joby.ai URL: https://www.joby.ai License: MIT Terms of Service

An API for searching Joby.ai's entire jobs and companies database.

💡 About

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.

🚀 Postman Collection

We've published a Postman Collection to make it easy to explore and test our API. You can find it here.

💌 Contact Us

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.

📜 Authentication

All API requests require authentication using an API key. Include your API key in the X-API-KEY header of each request.

Example 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'

🤝 Support

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 jobs

Search for jobs by keywords, location, and other parameters.

Authorizations:
ApiKey
query 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&not=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.

Responses

Request samples 

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'
  }
})

Response samples

Content type
application/json
[
  • {
    • "_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",
    • "job_board_link": "https://www.greenhouse.io",
    • "application_link": "https://www.greenhouse.io/apply",
    • "company_link": "https://www.insurancecompany.com",
    • "company_logo": "https://www.insurancecompany.com/logo.png",
    • "company_data": {
      • "description_summary": "string",
      • "linkedin_link": "http://example.com",
      • "size_range": {
        • "min": 1001,
        • "max": 5000
        },
      • "industries": [
        • "Finance",
        • "Real Estate"
        ],
      • "subindustries": [
        • "Insurance",
        • "Banking"
        ]
      },
    • "date_posted": "2023-10-18"
    }
]