OpenWeb Ninja JSearch API

https://www.openwebninja.com/api/jsearch/docs
Admin
The OpenWeb Ninja JSearch API provides real-time job listings and salary data from public sources...
Tokens:4,974
Snippets:24
Trust Score:6.6
Update:3 months ago
Show doc for...
Tokens:
Raw
### GET /search

Source: https://www.openwebninja.com/api/jsearch/docs

Search for job listings based on specific criteria.

```APIDOC
## GET /search

### Description
Search for job listings using a variety of filters including query, location, and employment type.

### Method
GET

### Endpoint
/search

### Parameters
#### Query Parameters
- **query** (string) - Required - The search term for jobs (e.g., "developer jobs in chicago")
- **cursor** (string) - Optional - Pagination cursor
- **num_pages** (integer) - Optional - Number of pages to return
- **country** (string) - Optional - Country code (e.g., "us")
- **language** (string) - Optional - Language code (e.g., "en")
- **date_posted** (string) - Optional - Filter by date posted
- **work_from_home** (boolean) - Optional - Filter for remote jobs
- **employment_types** (string) - Optional - Filter by employment type (e.g., "FULLTIME")
- **job_requirements** (string) - Optional - Filter by experience level (e.g., "under_3_years_experience")
- **radius** (integer) - Optional - Search radius
- **exclude_job_publishers** (string) - Optional - Comma-separated list of publishers to exclude
- **fields** (string) - Optional - Comma-separated list of fields to return
```

--------------------------------

### GET /search-v2

Source: https://www.openwebninja.com/api/jsearch/docs

Search for job postings using a free-form query and various filtering parameters.

```APIDOC
## GET /search-v2

### Description
Search for jobs posted on public job sites. Supports extensive filtering and cursor-based pagination.

### Method
GET

### Endpoint
https://api.openwebninja.com/jsearch/search-v2

### Parameters
#### Query Parameters
- **query** (string) - Required - Free-form job search query.
- **cursor** (string) - Optional - Cursor for paginating results, obtained from the previous response.
- **num_pages** (integer) - Optional - Number of pages to return (1-20).
- **country** (string) - Optional - Country code (default: "us").
- **language** (string) - Optional - Language code for results.
- **date_posted** (string) - Optional - Filter by time: all, today, 3days, week, month.
- **work_from_home** (boolean) - Optional - Filter for remote jobs.
- **employment_types** (string) - Optional - Comma delimited list: FULLTIME, CONTRACTOR, PARTTIME, INTERN.
- **job_requirements** (string) - Optional - Comma delimited list: under_3_years_experience, more_than_3_years_experience, no_experience, no_degree.
- **radius** (number) - Optional - Distance in km from location.
- **exclude_job_publishers** (string) - Optional - Comma separated list of publishers to exclude.
- **fields** (string) - Optional - Comma separated list of fields to include in the response.

### Request Example
curl 'https://api.openwebninja.com/jsearch/search-v2?query=developer%20jobs%20in%20chicago' \
  --header 'x-api-key: YOUR_SECRET_TOKEN'

### Response
#### Success Response (200)
- **status** (string) - Status of the request.
- **request_id** (string) - Unique identifier for the request.
- **parameters** (object) - Echo of the request parameters.
- **data** (object) - Contains the list of jobs and the cursor for pagination.
```

--------------------------------

### Job Details Response Schema

Source: https://www.openwebninja.com/api/jsearch/docs

Example JSON response structure returned by the job-details endpoint.

```json
{
  "Example": {
    "value": {
      "status": "OK",
      "request_id": "5a8e34f1-a27c-49ee-a5b5-45d2b98ee6aa",
      "parameters": {
        "job_id": "GrjRvpGsrjwtgFBuAAAAAA==",
        "country": "us",
        "language": "en"
      },
      "data": [
        {
          "job_id": "GrjRvpGsrjwtgFBuAAAAAA==",
          "job_title": "Senior Front-End Developer",
          "employer_name": "TEKsystems",
          "employer_logo": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQwWmR-XRuLFrKKxUHxaQbZaVgNBmK5Yxi04c5U&s=0",
          "employer_website": "http://www.teksystems.com/",
          "job_publisher": "TEKsystems Careers",
          "job_employment_type": "Full-time",
          "job_employment_types": [
            "FULLTIME"
          ],
          "job_apply_link": "https://careers.teksystems.com/us/en/job/JP-006039510/Senior-Front-End-Developer?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
          "job_apply_is_direct": false,
          "apply_options": [
            {
              "publisher": "TEKsystems Careers",
              "apply_link": "https://careers.teksystems.com/us/en/job/JP-006039510/Senior-Front-End-Developer?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "is_direct": false
            },
            {
              "publisher": "Built In Chicago",
              "apply_link": "https://www.builtinchicago.org/job/senior-front-end-developer/9339174?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "is_direct": false
            },
            {
              "publisher": "ZipRecruiter",
              "apply_link": "https://www.ziprecruiter.com/c/One-Design/Job/Senior-Front-end-Developer/-in-Chicago,IL?jid=406e78522a81edb2&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "is_direct": false
            }
          ],
          "job_description": "One North is a digital experience agency. As a Senior Front-End Developer, you'll work closely with every part of One North. Hard Skills: 3+ years experience, HTML/CSS/JavaScript, TypeScript, React, Next.js, SCSS, Figma. Pay range: $91,700 - $137,500/yr. This is a fully remote position.",
          "job_is_remote": null,
          "job_posted_at": "7 days ago",
          "job_posted_at_timestamp": 1779148800,
          "job_posted_at_datetime_utc": "2026-05-19T00:00:00.000Z",
          "job_location": "Chicago, IL",
          "job_city": "Chicago",
          "job_state": "Illinois",
          "job_country": "US",
          "job_latitude": 41.88325,
          "job_longitude": -87.6323879,
          "job_benefits": [
            "dental_coverage",
            "health_insurance",
            "paid_time_off"
          ],
          "job_google_link": "https://www.google.com/search?q=jobs&gl=us&hl=en&udm=8#vhid=vt%3D20/docid%3DGrjRvpGsrjwtgFBuAAAAAA%3D%3D&vssid=jobs-detail-viewer",
          "job_min_salary": 91700,
          "job_max_salary": 138000,
          "job_salary_period": "YEAR",
          "job_highlights": {
            "Qualifications": [
              "3 or more years of experience, ideally in an agency or consulting environment",
              "Advanced practitioner of HTML, CSS, and JavaScript using current best practices",
              "Strong proficiency with TypeScript"
```

--------------------------------

### Successful API Response Schema

Source: https://www.openwebninja.com/api/jsearch/docs

Example of a successful 200 OK response containing salary data, including median, minimum, and maximum salary figures.

```json
{
  "Example": {
    "value": {
      "status": "OK",
      "request_id": "2ff43de9-cf32-41b1-ad5b-847189f9129e",
      "parameters": {
        "job_title": "nodejs developer",
        "location": "new york",
        "location_type": "ANY",
        "years_of_experience": null
      },
      "data": [
        {
          "location": "New York City, NY",
          "job_title": "Nodejs Developer",
          "min_salary": 111845.69,
          "max_salary": 185866.24,
          "median_salary": 143099.6,
          "min_base_salary": 81915.06,
          "max_base_salary": 129995.73,
          "median_base_salary": 103192.09,
          "min_additional_pay": 29930.63,
          "max_additional_pay": 55870.51,
          "median_additional_pay": 39907.51,
          "salary_period": "YEAR",
          "salary_currency": "USD",
          "salary_count": 60,
          "salaries_updated_at": "2024-06-06T23:59:59.000Z",
          "publisher_name": "Glassdoor",
          "publisher_link": "https://www.glassdoor.com/Salaries/company-salaries.htm?suggestCount=0&suggestChosen=false&sc.keyword=Nodejs%20Developer&locT=C&locId=1132348",
          "confidence": "CONFIDENT"
        }
      ]
    }
  }
}
```

--------------------------------

### Successful API Response Schema

Source: https://www.openwebninja.com/api/jsearch/docs

Example of a successful JSON response structure returned by the search endpoint.

```json
{
  "Example": {
    "value": {
      "status": "OK",
      "request_id": "4f24fa29-a883-49f9-8dca-d0fede07203c",
      "parameters": {
        "query": "developer jobs in chicago",
        "page": 1,
        "num_pages": 1,
        "date_posted": "all",
        "country": "us",
        "language": "en"
      },
      "data": {
        "jobs": [
          {
            "job_id": "woj2gE2S_6LqvmLAAAAAAA==",
            "job_title": "Senior Developer",
            "employer_name": "United Airlines",
            "employer_logo": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS6DMswunk7F25_BeXSf2w8JVHG65s4lc7v5wfG&s=0",
            "employer_website": "https://www.united.com",
            "job_publisher": "United Airlines Jobs",
            "job_employment_type": "Full-time",
            "job_employment_types": [
              "FULLTIME"
```

--------------------------------

### GET /estimated-salary

Source: https://www.openwebninja.com/api/jsearch/docs

Retrieves estimated salary information for a specific job title and location.

```APIDOC
## GET /estimated-salary

### Description
Get estimated salaries or pay for jobs around a location by job title and location. The estimation is returned for several periods including hourly, daily, weekly, monthly, or yearly.

### Method
GET

### Endpoint
https://api.openwebninja.com/jsearch/estimated-salary

### Parameters
#### Query Parameters
- **job_title** (string) - Required - Job title for which to get salary estimation.
- **location** (string) - Required - Location in which to get salary estimation.
- **location_type** (string) - Optional - Specify the type of the location (ANY, CITY, STATE, COUNTRY). Default: "ANY".
- **years_of_experience** (string) - Optional - Get job estimation for a specific experience level range (ALL, LESS_THAN_ONE, ONE_TO_THREE, FOUR_TO_SIX, SEVEN_TO_NINE, TEN_TO_FOURTEEN, ABOVE_FIFTEEN). Default: "ALL".
- **fields** (string) - Optional - A comma separated list of job salary fields to include in the response.

### Request Example
curl 'https://api.openwebninja.com/jsearch/estimated-salary?job_title=nodejs%20developer&location=new%20york' \
  --header 'x-api-key: YOUR_SECRET_TOKEN'

### Response
#### Success Response (200)
- **status** (string) - Status of the request.
- **request_id** (string) - Unique identifier for the request.
- **parameters** (object) - Echo of the input parameters.
- **data** (array) - List of salary estimation objects.

#### Response Example
{
  "status": "OK",
  "request_id": "2ff43de9-cf32-41b1-ad5b-847189f9129e",
  "parameters": {
    "job_title": "nodejs developer",
    "location": "new york",
    "location_type": "ANY",
    "years_of_experience": null
  },
  "data": [
    {
      "location": "New York City, NY",
      "job_title": "Nodejs Developer",
      "min_salary": 111845.69,
      "max_salary": 185866.24,
      "median_salary": 143099.6,
      "salary_period": "YEAR",
      "salary_currency": "USD",
      "confidence": "CONFIDENT"
    }
  ]
}
```

--------------------------------

### GET /jsearch/job-details

Source: https://www.openwebninja.com/api/jsearch/docs

Retrieves detailed information for a specific job or a batch of jobs by their unique identifiers.

```APIDOC
## GET /jsearch/job-details

### Description
Get all job details, including additional information such as application options, links, employer reviews, and estimated salaries for similar jobs.

### Method
GET

### Endpoint
https://api.openwebninja.com/jsearch/job-details

### Parameters
#### Query Parameters
- **job_id** (string) - Required - Job Id of the job for which to get details. Batching of up to 20 Job Ids is supported by separating multiple Job Ids by comma (,).
- **country** (string) - Optional - Country code of the country from which to return job posting. Default: "us".
- **language** (string) - Optional - Language code in which to return job postings.
- **fields** (string) - Optional - A comma separated list of job fields to include in the response (field projection).

### Request Example
curl 'https://api.openwebninja.com/jsearch/job-details?job_id=20N57zBfi3eT9BdpAAAAAA%3D%3D' \
  --header 'x-api-key: YOUR_SECRET_TOKEN'

### Response
#### Success Response (200)
- **status** (string) - Status of the request.
- **request_id** (string) - Unique identifier for the request.
- **data** (array) - List of job details objects.

#### Response Example
{
  "status": "OK",
  "request_id": "5a8e34f1-a27c-49ee-a5b5-45d2b98ee6aa",
  "data": [
    {
      "job_id": "GrjRvpGsrjwtgFBuAAAAAA==",
      "job_title": "Senior Front-End Developer",
      "employer_name": "TEKsystems"
    }
  ]
}
```

--------------------------------

### GET /company-job-salary

Source: https://www.openwebninja.com/api/jsearch/docs

Retrieves estimated job salaries for a specific company by job title, with optional filters for location and experience level.

```APIDOC
## GET /company-job-salary

### Description
Get estimated job salaries/pay in a specific company by job title and optionally a location and experience level in years.

### Method
GET

### Endpoint
https://api.openwebninja.com/jsearch/company-job-salary

### Parameters
#### Query Parameters
- **company** (string) - Required - The company name for which to get salary information.
- **job_title** (string) - Required - Job title for which to get salary estimation.
- **location** (string) - Optional - Free-text location/area in which to get salary estimation.
- **location_type** (string) - Optional - Specify the type of the location (ANY, CITY, STATE, COUNTRY).
- **years_of_experience** (string) - Optional - Get job estimation for a specific experience level range (ALL, LESS_THAN_ONE, ONE_TO_THREE, FOUR_TO_SIX, SEVEN_TO_NINE, TEN_TO_FOURTEEN, ABOVE_FIFTEEN).

### Request Example
curl 'https://api.openwebninja.com/jsearch/company-job-salary?company=Amazon&job_title=software%20developer' \
  --header 'x-api-key: YOUR_SECRET_TOKEN'

### Response
#### Success Response (200)
- **status** (string) - Status of the request.
- **request_id** (string) - Unique identifier for the request.
- **data** (array) - List of salary data objects.

#### Response Example
{
  "status": "OK",
  "request_id": "4be77792-6727-49f4-a2d9-9040b146d8f5",
  "data": [
    {
      "location": "United States",
      "job_title": "Software Developer",
      "company": "Amazon",
      "min_salary": 140594.13,
      "max_salary": 209058.84,
      "median_salary": 170162.89,
      "salary_period": "YEAR",
      "salary_currency": "USD",
      "confidence": "CONFIDENT",
      "salary_count": 1009
    }
  ]
}
```

--------------------------------

### Retrieve Job Details via cURL

Source: https://www.openwebninja.com/api/jsearch/docs

Use this command to fetch job details by providing a valid job_id and your API key.

```shell
curl 'https://api.openwebninja.com/jsearch/job-details?job_id=20N57zBfi3eT9BdpAAAAAA%3D%3D' \
  --header 'x-api-key: YOUR_SECRET_TOKEN'
```

--------------------------------

### Search for jobs using cURL

Source: https://www.openwebninja.com/api/jsearch/docs

Perform a job search request by providing a query and an API key.

```shell
curl 'https://api.openwebninja.com/jsearch/search-v2?query=developer%20jobs%20in%20chicago' \
  --header 'x-api-key: YOUR_SECRET_TOKEN'
```

--------------------------------

### Retrieve Company Job Salary via cURL

Source: https://www.openwebninja.com/api/jsearch/docs

Use this cURL command to fetch salary estimates for a specific company and job title. Ensure the x-api-key header is replaced with your valid secret token.

```shell
curl 'https://api.openwebninja.com/jsearch/company-job-salary?company=Amazon&job_title=software%20developer' \
  --header 'x-api-key: YOUR_SECRET_TOKEN'
```

--------------------------------

### Retrieve Job Salary via cURL

Source: https://www.openwebninja.com/api/jsearch/docs

Use this request to fetch salary estimations for a specific job title and location. Ensure the 'x-api-key' header is replaced with your valid secret token.

```shell
curl 'https://api.openwebninja.com/jsearch/estimated-salary?job_title=nodejs%20developer&location=new%20york' \
  --header 'x-api-key: YOUR_SECRET_TOKEN'
```

--------------------------------

### Company Job Salary API Response Schema

Source: https://www.openwebninja.com/api/jsearch/docs

This JSON structure represents a successful 200 response containing salary statistics such as median, minimum, and maximum pay.

```json
{
  "Example": {
    "value": {
      "status": "OK",
      "request_id": "4be77792-6727-49f4-a2d9-9040b146d8f5",
      "data": [
        {
          "location": "United States",
          "job_title": "Software Developer",
          "company": "Amazon",
          "min_salary": 140594.13,
          "max_salary": 209058.84,
          "median_salary": 170162.89,
          "min_base_salary": 111791.03,
          "max_base_salary": 155293.04,
          "median_base_salary": 131758.75,
          "min_additional_pay": 28803.1,
          "max_additional_pay": 53765.8,
          "median_additional_pay": 38404.14,
          "salary_period": "YEAR",
          "salary_currency": "USD",
          "confidence": "CONFIDENT",
          "salary_count": 1009
        }
      ]
    }
  }
}
```
Tokens:
Raw