# Real-Time Jobs Data API

> Complete reference documentation for the OpenWeb Ninja Real-Time Jobs Data API. Includes code examples, data samples, and usage guides for searching millions of job listings, fetching full job details, estimating salaries, and getting employer reviews, interviews, and company data from Google for Jobs and Glassdoor in Real-Time.

## Overview

Complete reference documentation for the OpenWeb Ninja Real-Time Jobs Data API. Includes code examples, data samples, and usage guides for searching millions of job listings, fetching full job details, estimating salaries, and getting employer reviews, interviews, and company data from Google for Jobs and Glassdoor in Real-Time.

This API exposes 10 REST endpoints (Job Search, Job Details, Job Search, Job Salary, Employer Search, Employer Details, Employer Reviews, Employer Jobs, Employer Salary, Employer Interviews), returning structured JSON. See the endpoints below for parameters and full URLs.

Need help integrating? Contact support@openwebninja.com.
For high volume / large scale plans, please contact support@openwebninja.com.

## Endpoints

### GET /google-jobs/search - Job Search
Search for jobs posted on any public job site across the web on the largest job aggregate in the world (Google for Jobs).
Parameters:
- **query** (string, required, e.g. `developer jobs in chicago`): Free-form jobs search query. It is highly recommended to include job title and location as part of the query, see query examples below. **Examples:** `web development jobs in chicago` `marketing manager in new york via linkedin`
- page (integer, default: `1`): Page to return (each page includes up to 10 results). **Allowed values:** `1-100`
- num_pages (integer, default: `1`): Number of pages to return, starting from page. **Allowed values:** `1-20` **Note**: Each page (containing up to 10 results) returned by the API consumes one request credit.
- country (string, default: `us`): Country code of the country from which to return job postings. Please note that this parameter must be set in order to get jobs in a specific country, for example, to query for software developer jobs in Berlin, one should add *country=de* to the request - *e.g. query=software+developers+in +berlin&country=de*. For the list of supported values see *https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
- language (string, e.g. `en`): Language code in which to return job postings. Leave empty to use the primary language in the specified country (country parameter). In case a language not supported by the specified country is used, it is likely that no results will be returned. For the list of supported values see https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes
- date_posted (string, default: `all`, allowed: all | today | 3days | week | month): Find jobs posted within the time you specify.
- work_from_home (boolean, default: `false`): Only return work from home / remote jobs.
- employment_types (string, allowed: FULLTIME | CONTRACTOR | PARTTIME | INTERN, e.g. `FULLTIME`): Find jobs of particular employment types, specified as a comma delimited list of the following values:
- job_requirements (string, allowed: under_3_years_experience | more_than_3_years_experience | no_experience | no_degree, e.g. `no_experience`): Find jobs with specific requirements, specified as a comma delimited list of the following values:
- radius (number, e.g. `1`): Return jobs within a certain distance from location as specified as part of the query (in km). This internally sent as the Google "lrad" parameter and although it might affect the results, it is not strictly followed by Google for Jobs.
- exclude_job_publishers (string, e.g. `BeeBe,Dice`): Exclude jobs published by specific publishers, specified as a comma (,) separated list of publishers to exclude.
- fields (string, e.g. `employer_name,job_publisher,job_title,job_country`): A comma separated list of job fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-jobs-data/google-jobs/search`

### GET /google-jobs/job-details - Job Details
Get all job details, including additional information such as: application options / links, employer reviews and estimated salaries for similar jobs.
Parameters:
- **job_id** (string, required, e.g. `20N57zBfi3eT9BdpAAAAAA==`): 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 (,). Note that each Job Id in a batch request is counted as a request for quota calculation.
- country (string, default: `us`): Country code of the country from which to return job posting. **Allowed values:** See *https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2*
- language (string, e.g. `en`): Language code in which to return job postings. Leave empty to use the primary language in the specified country (country parameter). **Allowed values:** See *https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes*
- fields (string, e.g. `employer_name,job_publisher,job_title,job_country`): A comma separated list of job fields to include in the response (field projection). By default all fields are returned.
Full URL: `https://api.openwebninja.com/realtime-jobs-data/google-jobs/job-details`

### GET /glassdoor/job-search - Job Search
Search for jobs with various filters and options as available on https://www.glassdoor.com/Job/index.htm.
Parameters:
- **query** (string, required, e.g. `front end developer`)
- **location** (string, required, e.g. `new york`)
- location_type (string, default: `ANY`, allowed: ANY | CITY | STATE | COUNTRY): Specify the type of the location you are looking to get salary estimation for additional accuracy.
- limit (number, default: `10`): The maximum number of results to return in a single response. If not specified, a default value is used. Use with cursor to paginate through larger result sets.
- cursor (string)
- easy_apply_only (boolean): Only return jobs with easy apply.
- remote_only (string, e.g. `do_not_include_in_request_key`)
- date_posted (string, default: `all`, allowed: all | today | 3days | week | 2weeks | month): Only return jobs posted within the specified time frame, as available in the Date Posted filter on Glassdoor.
- min_company_rating (string, e.g. `ANY`)
- domain (string, default: `www.glassdoor.com`, allowed: www.glassdoor.com | www.glassdoor.co.uk | www.glassdoor.com.ar | www.glassdoor.com.au | www.glassdoor.be | www.glassdoor.be | www.glassdoor.com.br | www.glassdoor.ca | www.glassdoor.ca | www.glassdoor.de | www.glassdoor.es | www.glassdoor.fr | www.glassdoor.com.hk | www.glassdoor.co.in | www.glassdoor.ie | www.glassdoor.it | www.glassdoor.com.mx | www.glassdoor.nl | www.glassdoor.co.nz | www.glassdoor.at | de.glassdoor.ch | www.glassdoor.sg | fr.glassdoor.ch): The Glassdoor domain to use.
Full URL: `https://api.openwebninja.com/realtime-jobs-data/glassdoor/job-search`

### GET /glassdoor/salary-estimation - Job Salary
Get salary estimates by job title and location.
Parameters:
- **job_title** (string, required, e.g. `software developer`): The job title for which to get salary estimation (e.g. marketing assistant).
- **location** (string, required, e.g. `new york`): The location for which to get salary estimation (e.g. san-francisco, us).
- location_type (string, default: `ANY`, allowed: ANY | CITY | STATE | COUNTRY): Specify the type of the location you are looking to get salary estimation for additional accuracy.
- years_of_experience (string, default: `ALL`, allowed: ALL | LESS_THAN_ONE | ONE_TO_THREE | FOUR_TO_SIX | SEVEN_TO_NINE | TEN_TO_FOURTEEN | ABOVE_FIFTEEN): Get job estimation for a specific experience level range (years).
- domain (string, default: `www.glassdoor.com`, allowed: www.glassdoor.com | www.glassdoor.co.uk | www.glassdoor.com.ar | www.glassdoor.com.au | www.glassdoor.be | www.glassdoor.be | www.glassdoor.com.br | www.glassdoor.ca | www.glassdoor.ca | www.glassdoor.de | www.glassdoor.es | www.glassdoor.fr | www.glassdoor.com.hk | www.glassdoor.co.in | www.glassdoor.ie | www.glassdoor.it | www.glassdoor.com.mx | www.glassdoor.nl | www.glassdoor.co.nz | www.glassdoor.at | de.glassdoor.ch | www.glassdoor.sg | fr.glassdoor.ch): The Glassdoor domain to use.
Full URL: `https://api.openwebninja.com/realtime-jobs-data/glassdoor/salary-estimation`

### GET /glassdoor/company-search - Employer Search
Search for companies (employers) on Glassdoor.
Parameters:
- **query** (string, required, e.g. `goo`): Search query or Company ID
- limit (number, default: `10`): Maximum number of results to return.
- domain (string, default: `www.glassdoor.com`, allowed: www.glassdoor.com | www.glassdoor.co.uk | www.glassdoor.com.ar | www.glassdoor.com.au | www.glassdoor.be | www.glassdoor.be | www.glassdoor.com.br | www.glassdoor.ca | www.glassdoor.ca | www.glassdoor.de | www.glassdoor.es | www.glassdoor.fr | www.glassdoor.com.hk | www.glassdoor.co.in | www.glassdoor.ie | www.glassdoor.it | www.glassdoor.com.mx | www.glassdoor.nl | www.glassdoor.co.nz | www.glassdoor.at | de.glassdoor.ch | www.glassdoor.sg | fr.glassdoor.ch): The Glassdoor domain to use.
Full URL: `https://api.openwebninja.com/realtime-jobs-data/glassdoor/company-search`

### GET /glassdoor/company-overview - Employer Details
Get company (employer) overview/details from Glassdoor (e.g.
Parameters:
- **company_id** (string, required, e.g. `1138`): Glassdoor company ID
- domain (string, default: `www.glassdoor.com`, allowed: www.glassdoor.com | www.glassdoor.co.uk | www.glassdoor.com.ar | www.glassdoor.com.au | www.glassdoor.be | www.glassdoor.be | www.glassdoor.com.br | www.glassdoor.ca | www.glassdoor.ca | www.glassdoor.de | www.glassdoor.es | www.glassdoor.fr | www.glassdoor.com.hk | www.glassdoor.co.in | www.glassdoor.ie | www.glassdoor.it | www.glassdoor.com.mx | www.glassdoor.nl | www.glassdoor.co.nz | www.glassdoor.at | de.glassdoor.ch | www.glassdoor.sg | fr.glassdoor.ch): The Glassdoor domain to use.
Full URL: `https://api.openwebninja.com/realtime-jobs-data/glassdoor/company-overview`

### GET /glassdoor/company-reviews - Employer Reviews
Get company (employer) reviews from Glassdoor, with filters, sort option, and pagination support.
Parameters:
- **company_id** (string, required, default: `9079`): Glassdoor company ID.
- page (integer, default: `1`): The reviews page to return (each page includes up to 10 results).
- sort (string, default: `POPULAR`, allowed: POPULAR | MOST_RECENT | HIGHEST_RATING | LOWEST_RATING): Return reviews in a specific sort order.
- query (string)
- language (string, default: `en`, allowed: en | fr | nl | de | pt | es | it): Return reviews written in a specific language.
- employment_statuses (string, allowed: REGULAR | INTERN | PART_TIME | CONTRACT | FREELANCE): Return reviews written by employees with a specific job type.
- only_current_employees (string, default: `false`)
- extended_rating_data (boolean, default: `false`)
- domain (string, default: `www.glassdoor.com`, allowed: www.glassdoor.com | www.glassdoor.co.uk | www.glassdoor.com.ar | www.glassdoor.com.au | www.glassdoor.be | www.glassdoor.be | www.glassdoor.com.br | www.glassdoor.ca | www.glassdoor.ca | www.glassdoor.de | www.glassdoor.es | www.glassdoor.fr | www.glassdoor.com.hk | www.glassdoor.co.in | www.glassdoor.ie | www.glassdoor.it | www.glassdoor.com.mx | www.glassdoor.nl | www.glassdoor.co.nz | www.glassdoor.at | de.glassdoor.ch | www.glassdoor.sg | fr.glassdoor.ch): The Glassdoor domain to use.
Full URL: `https://api.openwebninja.com/realtime-jobs-data/glassdoor/company-reviews`

### GET /glassdoor/company-jobs - Employer Jobs
Get jobs posted by a specific company with filtering support and additional options available on Glassdoor.
Parameters:
- **company_id** (string, required, default: `1138`): Glassdoor company ID or name (e.g. 9079 / e.g. Amazon)
- page (integer, default: `1`): The page to return (each page includes up to 10 job listings).
- sort (string, default: `MOST_RELEVANT`, allowed: MOST_RELEVANT | MOST_RECENT): Return reviews in a specific sort order.
- job_function (string, default: `ANY`, allowed: ANY | ADMINISTRATIVE | ARTS_AND_DESIGN | BUSINESS | CONSULTING | CUSTOMER_SERVICES_AND_SUPPORT | EDUCATION | ENGINEERING | FINANCE_AND_ACCOUNTING | HEALTHCARE | HUMAN_RESOURCES | INFORMATION_TECHNOLOGY | LEGAL | MARKETING | MEDIA_AND_COMMUNICATIONS | MILITARY_AND_PROTECTIVE_SERVICES | OPERATIONS | OTHER | PRODUCT_AND_PROJECT_MANAGEMENT | RESEARCH_AND_SCIENCE | RETAIL_AND_FOOD_SERVICES | SALES | SKILLED_LABOR_AND_MANUFACTURING | TRANSPORTATION): Return interviews for a specific job function.
- location (string): The location for which to get interviews (e.g. San-Francisco).
- location_type (string, default: `ANY`, allowed: ANY | CITY | STATE | COUNTRY): Specify the type of the location you are looking to get salary estimation for additional accuracy.
- max_age_days (number, default: `0`)
- domain (string, default: `www.glassdoor.com`, allowed: www.glassdoor.com | www.glassdoor.co.uk | www.glassdoor.com.ar | www.glassdoor.com.au | www.glassdoor.be | www.glassdoor.be | www.glassdoor.com.br | www.glassdoor.ca | www.glassdoor.ca | www.glassdoor.de | www.glassdoor.es | www.glassdoor.fr | www.glassdoor.com.hk | www.glassdoor.co.in | www.glassdoor.ie | www.glassdoor.it | www.glassdoor.com.mx | www.glassdoor.nl | www.glassdoor.co.nz | www.glassdoor.at | de.glassdoor.ch | www.glassdoor.sg | fr.glassdoor.ch): The Glassdoor domain to use.
Full URL: `https://api.openwebninja.com/realtime-jobs-data/glassdoor/company-jobs`

### GET /glassdoor/company-salaries-v2 - Employer Salary
Get and Search Company Data, Jobs, Employer Reviews, Salaries, Interviews, and More from Glassdoor in Real-Time (unofficial API).
Parameters:
- **company_id** (string, required, e.g. `1138`): Glassdoor company ID or name (e.g. 9079 / e.g. Amazon)
- location (string): The location for which to get salary estimation (e.g. San Francisco).
- location_type (string, default: `ANY`, allowed: ANY | CITY | STATE | COUNTRY): Specify the type of the location you are looking to get salary estimation for additional accuracy.
- job_title (string): The job title for which to get salary estimation
- page (number, default: `1`): The salaries page to return (each page includes up to 10 results).
- sort (string, default: `MOST_SALARIES`, allowed: MOST_SALARIES | HIGH_TO_LOW | MOST_RECENT): Return salaries in a specific sort order.
- domain (string, default: `www.glassdoor.com`, allowed: www.glassdoor.com | www.glassdoor.co.uk | www.glassdoor.com.ar | www.glassdoor.com.au | www.glassdoor.be | www.glassdoor.be | www.glassdoor.com.br | www.glassdoor.ca | www.glassdoor.ca | www.glassdoor.de | www.glassdoor.es | www.glassdoor.fr | www.glassdoor.com.hk | www.glassdoor.co.in | www.glassdoor.ie | www.glassdoor.it | www.glassdoor.com.mx | www.glassdoor.nl | www.glassdoor.co.nz | www.glassdoor.at | de.glassdoor.ch | www.glassdoor.sg | fr.glassdoor.ch): The Glassdoor domain to use.
Full URL: `https://api.openwebninja.com/realtime-jobs-data/glassdoor/company-salaries-v2`

### GET /glassdoor/company-interviews - Employer Interviews
Get interviews made by the company, including questions, difficulty, outcome, and more data about interviews.
Parameters:
- **company_id** (string, required, e.g. `1138`): Company ID
- page (number, default: `1`): The reviews page to return (each page includes up to 10 results).
- page_size (number, default: `10`): Maximum interview results to return in each page. Important note: when page > 1000, only 5 items are returned per page (higher page_size values are overridden) - this is due to Glassdoor's behavior.
- sort (string, default: `POPULAR`, allowed: POPULAR | MOST_RECENT | OLDEST | EASIEST | MOST_DIFFICULT): Return interviews in a specific sort order.
- job_function (string, default: `ANY`, allowed: ANY | ADMINISTRATIVE | ARTS_AND_DESIGN | BUSINESS | CONSULTING | CUSTOMER_SERVICES_AND_SUPPORT | EDUCATION | ENGINEERING | FINANCE_AND_ACCOUNTING | HEALTHCARE | HUMAN_RESOURCES | INFORMATION_TECHNOLOGY | LEGAL | MARKETING | MEDIA_AND_COMMUNICATIONS | MILITARY_AND_PROTECTIVE_SERVICES | OPERATIONS | OTHER | PRODUCT_AND_PROJECT_MANAGEMENT | RESEARCH_AND_SCIENCE | RETAIL_AND_FOOD_SERVICES | SALES | SKILLED_LABOR_AND_MANUFACTURING | TRANSPORTATION): Return interviews for a specific job function.
- job_title (string)
- location (string, e.g. `San-Francisco`)
- location_type (string, default: `ANY`, allowed: ANY | CITY | STATE | COUNTRY): Specify the type of the location you are looking to get salary estimation for additional accuracy.
- received_offer_only (boolean)
- domain (string, default: `www.glassdoor.com`, allowed: www.glassdoor.com | www.glassdoor.co.uk | www.glassdoor.com.ar | www.glassdoor.com.au | www.glassdoor.be | www.glassdoor.be | www.glassdoor.com.br | www.glassdoor.ca | www.glassdoor.ca | www.glassdoor.de | www.glassdoor.es | www.glassdoor.fr | www.glassdoor.com.hk | www.glassdoor.co.in | www.glassdoor.ie | www.glassdoor.it | www.glassdoor.com.mx | www.glassdoor.nl | www.glassdoor.co.nz | www.glassdoor.at | de.glassdoor.ch | www.glassdoor.sg | fr.glassdoor.ch): The Glassdoor domain to use.
Full URL: `https://api.openwebninja.com/realtime-jobs-data/glassdoor/company-interviews`

## Base URL and Authentication

- Base URL: `https://api.openwebninja.com/realtime-jobs-data`
- Auth: API key in the `x-api-key` header. Get a key by subscribing (free tier available) at https://app.openwebninja.com/api/realtime-jobs-data

## Links

- API page: https://www.openwebninja.com/api/real-time-jobs-data
- Get an API key / subscribe: https://app.openwebninja.com/api/realtime-jobs-data
- Pricing & plans: https://app.openwebninja.com/api/realtime-jobs-data/pricing
- Website: https://www.openwebninja.com
- OpenAPI spec: https://openwebninja.s3.us-east-1.amazonaws.com/portal/openapi/realtime_jobs_data.yaml
- Support: support@openwebninja.com

_Last updated: 2026-05-27_