### Get Job Details Source: https://www.openwebninja.com/api/jsearch/docs/index Retrieves detailed information for one or more jobs, including application options, employer reviews, and estimated salaries. ```APIDOC ## GET /jsearch/job-details ### Description Retrieves detailed information for one or more jobs, including application options, employer reviews, and estimated salaries. ### Method GET ### Endpoint /jsearch/job-details ### Parameters #### Query Parameters - **job_id** (string) - Required - The 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 (,). Each Job ID in a batch request is counted as a request for quota calculation. - **country** (string) - Optional - 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) - Optional - Language code in which to return job postings. Leave empty to use the primary language in the specified country. Allowed values: See https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes - **fields** (string) - Optional - A comma-separated list of job fields to include in the response (field projection). By default, all fields are returned. ### Request Example ```bash curl 'https://api.openwebninja.com/jsearch/job-details?job_id=gcnkkB1_QjIlxbV9AAAAAA%3D%3D&country=us&language=en&fields=employer_name%2Cjob_publisher%2Cjob_title%2Cjob_country' \ --header 'x-api-key: YOUR_SECRET_TOKEN' ``` ### Response #### Success Response (200) - **status** (string) - The status of the request. - **request_id** (string) - A unique identifier for the request. - **parameters** (object) - The parameters used for the request. - **data** (array) - An array of job details. - **job_id** (string) - The unique identifier for the job. - **job_title** (string) - The title of the job. - **employer_name** (string) - The name of the employer. - **employer_logo** (string) - The URL of the employer's logo. - **employer_website** (string) - The website of the employer. - **job_publisher** (string) - The publisher of the job posting. - **job_employment_type** (string) - The employment type of the job (e.g., "Contractor"). - **job_employment_types** (array) - A list of employment types for the job. - **job_apply_link** (string) - The direct link to apply for the job. - **job_apply_is_direct** (boolean) - Indicates if the application link is direct. - **apply_options** (array) - A list of available application options. - **publisher** (string) - The publisher of the apply option. - **apply_link** (string) - The link to apply through the publisher. - **is_direct** (boolean) - Indicates if the application is direct. - **job_description** (string) - A detailed description of the job. - **job_is_remote** (boolean) - Indicates if the job is remote. - **job_posted_at** (string) - The date the job was posted. - **job_posted_at_timestamp** (integer) - The timestamp when the job was posted. - **job_posted_at_datetime_utc** (string) - The date and time the job was posted in UTC. #### Response Example ```json { "status": "OK", "request_id": "05cd8311-fdd1-4822-831b-fa13eb05f01f", "parameters": { "job_id": "20N57zBfi3eT9BdpAAAAAA==", "country": "us", "language": "en" }, "data": [ { "job_id": "20N57zBfi3eT9BdpAAAAAA==", "job_title": "JavaScript Backend Developer", "employer_name": "IT Engagements, Inc.", "employer_logo": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQdiK9i1psQm2cIFbZe06v_LCI_-5c5GR4UXsGu&s=0", "employer_website": null, "job_publisher": "LinkedIn", "job_employment_type": "Contractor", "job_employment_types": [ "CONTRACTOR", "CONTRACTOR" ], "job_apply_link": "https://www.linkedin.com/jobs/view/javascript-backend-developer-at-it-engagements-inc-4148684949?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic", "job_apply_is_direct": false, "apply_options": [ { "publisher": "LinkedIn", "apply_link": "https://www.linkedin.com/jobs/view/javascript-backend-developer-at-it-engagements-inc-4148684949?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic", "is_direct": false }, { "publisher": "JobLeads", "apply_link": "https://www.jobleads.com/us/job/javascript-backend-developer--chicago--e3e359ff9336688178f270a184e5cb51a?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic", "is_direct": false }, { "publisher": "Learn4Good", "apply_link": "https://www.learn4good.com/jobs/chicago/illinois/info_technology/3957218611/e/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic", "is_direct": false }, { "publisher": "Jobilize", "apply_link": "https://www.jobilize.com/job/us-il-chicago-javascript-backend-developer-compunnel-hiring-now-job?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic", "is_direct": false } ], "job_description": "Greetings from IT Engagements…!\n\nIT Engagements is a global staff augmentation firm providing a wide-range of talent on-demand and total workforce solutions. We have an immediate opening for the below position with one of our premium clients.\n\nJob Title:- JavaScript Backend Developer\n\nDuration:- 12+ Months Contract (Possibility of further extension)\n\nLocation:- Hybrid (3day/Week Onsite) at Chicago, IL.\n\nVisa:- USC, GC, GC-EAD, H4-EAD (No Third-Party Candidates)\n\nJob Description:-\n• Communication skills are the KEY! We need a Solution type person. This person is going to have to have a great personality and awesome communication skills\n• JavaScript Backend Developer (NO Front-end work) – ALL JavaScript backend Development.\n• Must have 10 years of JavaScript backend Development experience.\n• Must have SDK Experience.\n\nRegards,\n\nShashank Jaitly\n\nShashank@itengagements.com", "job_is_remote": null, "job_posted_at": null, "job_posted_at_timestamp": null, "job_posted_at_datetime_utc": null } ] } ``` -------------------------------- ### Fetch Job Details using cURL Source: https://www.openwebninja.com/api/jsearch/docs/index Example cURL command to retrieve details for a specific job posting. It includes parameters for job ID, country, language, and specific fields to return. Ensure you replace 'YOUR_SECRET_TOKEN' with your actual API key. ```shell curl 'https://api.openwebninja.com/jsearch/job-details?job_id=gcnkkB1_QjIlxbV9AAAAAA%3D%3D&country=us&language=en&fields=employer_name%2Cjob_publisher%2Cjob_title%2Cjob_country' \ --header 'x-api-key: YOUR_SECRET_TOKEN' ``` -------------------------------- ### Job Search Request Example (Shell/Curl) Source: https://www.openwebninja.com/api/jsearch/docs/index This code snippet demonstrates how to perform a job search using a cURL command. It includes various parameters to filter job results, such as query, page number, country, language, date posted, work from home preference, employment type, job requirements, radius, excluded publishers, and requested fields. Replace 'YOUR_SECRET_TOKEN' with your actual API key. ```shell curl 'https://api.openwebninja.com/jsearch/search?query=developer%20jobs%20in%20chicago&page=1&num_pages=1&country=us&language=en&date_posted=today&work_from_home=false&employment_types=FULLTIME&job_requirements=no_experience&radius=1&exclude_job_publishers=BeeBe%2CDice&fields=employer_name%2Cjob_publisher%2Cjob_title%2Cjob_country' \ --header 'x-api-key: YOUR_SECRET_TOKEN' ``` -------------------------------- ### Get Company Job Salary Information (Shell) Source: https://www.openwebninja.com/api/jsearch/docs/index Retrieves estimated job salaries for a specific company, job title, and optionally location and experience level. Requires an API key for authentication. Parameters include company name, job title, location, location type, and years of experience. ```shell curl 'https://api.openwebninja.com/jsearch/company-job-salary?company=Amazon&job_title=software%20developer&location=NY&location_type=CITY&years_of_experience=LESS_THAN_ONE' \ --header 'x-api-key: YOUR_SECRET_TOKEN' ``` -------------------------------- ### Get Estimated Salary Source: https://www.openwebninja.com/api/jsearch/docs/index Retrieve estimated salary information for a job title in a specific location. This endpoint provides salary details for different periods and experience levels. ```APIDOC ## GET /jsearch/estimated-salary ### Description Get estimated salaries / pay for jobs around a location by job title and location. The salary estimation is returned for several periods, depending on data availability / relevance, and includes: hourly, daily, weekly, monthly, or yearly. ### Method GET ### Endpoint /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, enum) - Optional - Specify the type of the location you are looking to get salary estimation for additional accuracy. Options: ANY, CITY, STATE, COUNTRY. Defaults to "ANY". - **years_of_experience** (string, enum) - Optional - Get job estimation for a specific experience level range (years). Options: ALL, LESS_THAN_ONE, ONE_TO_THREE, FOUR_TO_SIX, SEVEN_TO_NINE, TEN_TO_FOURTEEN, ABOVE_FIFTEEN. Defaults to "ALL". - **fields** (string) - Optional - A comma separated list of job salary fields to include in the response (field projection). By default all fields are returned. ### Request Example ```curl curl 'https://api.openwebninja.com/jsearch/estimated-salary?job_title=nodejs%20developer&location=new%20york&location_type=CITY&years_of_experience=LESS_THAN_ONE&fields=job_title%2Cmedian_salary%2Clocation' \ --header 'x-api-key: YOUR_SECRET_TOKEN' ``` ### Response #### Success Response (200) - **status** (string) - Status of the response. - **request_id** (string) - Unique identifier for the request. - **parameters** (object) - The parameters used for the request. - **data** (array) - An array of job salary objects. - **location** (string) - The location of the job. - **job_title** (string) - The title of the job. - **min_salary** (number) - The minimum estimated salary. - **max_salary** (number) - The maximum estimated salary. - **median_salary** (number) - The median estimated salary. - **min_base_salary** (number) - The minimum estimated base salary. - **max_base_salary** (number) - The maximum estimated base salary. - **median_base_salary** (number) - The median estimated base salary. - **min_additional_pay** (number) - The minimum estimated additional pay. - **max_additional_pay** (number) - The maximum estimated additional pay. - **median_additional_pay** (number) - The median estimated additional pay. - **salary_period** (string) - The period for the salary (e.g., YEAR, MONTH). - **salary_currency** (string) - The currency of the salary. - **salary_count** (integer) - The number of salary data points used for estimation. - **salaries_updated_at** (string) - The timestamp when the salary data was last updated. - **publisher_name** (string) - The name of the publisher providing the salary data. - **publisher_link** (string) - A link to the publisher's salary information. - **confidence** (string) - The confidence level of the salary estimation. #### Response Example ```json { "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" } ] } ``` ``` -------------------------------- ### GET /jsearch/search Source: https://www.openwebninja.com/api/jsearch/docs/index Searches for jobs based on provided query parameters. Supports filtering by location, page number, number of pages, country, language, date posted, work-from-home status, employment types, job requirements, radius, and excluded publishers. ```APIDOC ## GET /jsearch/search ### Description Searches for jobs based on provided query parameters. Supports filtering by location, page number, number of pages, country, language, date posted, work-from-home status, employment types, job requirements, radius, and excluded publishers. ### Method GET ### Endpoint /jsearch/search ### Parameters #### Query Parameters - **query** (string) - Required - Free-form jobs search query. It is highly recommended to include job title and location as part of the query. - **page** (integer) - Optional - Page to return (each page includes up to 10 results). Default: 1. Allowed values: 1-100. - **num_pages** (integer) - Optional - Number of pages to return, starting from page. Default: 1. Allowed values: 1-20. - **country** (string) - Optional - Country code of the country from which to return job postings. Default: "us". - **language** (string) - Optional - Language code in which to return job postings. Leave empty to use the primary language in the specified country. - **date_posted** (string) - Optional - Find jobs posted within the time you specify. Allowed values: "all", "today", "3days", "week", "month". Default: "all". - **work_from_home** (boolean) - Optional - Only return work from home / remote jobs. Default: false. - **employment_types** (string) - Optional - Find jobs of particular employment types, specified as a comma delimited list. Allowed values: "FULLTIME", "CONTRACTOR", "PARTTIME", "INTERN". - **job_requirements** (string) - Optional - Find jobs with specific requirements, specified as a comma delimited list. Allowed values: "under_3_years_experience", "more_than_3_years_experience", "no_experience", "no_degree". - **radius** (number) - Optional - Return jobs within a certain distance from location as specified as part of the query (in km). - **exclude_job_publishers** (string) - Optional - Exclude jobs published by specific publishers, specified as a comma (,) separated list of publishers to exclude. - **fields** (string) - Optional - A comma separated list of job fields to include in the response (field projection). By default all fields are returned. ### Request Example ```json { "query": "developer jobs in chicago", "page": 1, "num_pages": 1, "country": "us", "language": "en", "date_posted": "today", "work_from_home": false, "employment_types": "FULLTIME", "job_requirements": "no_experience", "radius": 1, "exclude_job_publishers": "BeeBe,Dice", "fields": "employer_name,job_publisher,job_title,job_country" } ``` ### Response #### Success Response (200) - **status** (string) - The status of the request. - **request_id** (string) - A unique identifier for the request. - **parameters** (object) - The parameters used for the request. - **data** (array) - An array of job postings. - **job_id** (string) - Unique identifier for the job. - **job_title** (string) - The title of the job. - **employer_name** (string) - The name of the employer. - **employer_logo** (string) - URL to the employer's logo. - **employer_website** (string) - The website of the employer. - **job_publisher** (string) - The publisher of the job listing. - **job_employment_type** (string) - The employment type of the job. - **job_employment_types** (array) - List of employment types for the job. - **job_apply_link** (string) - URL to apply for the job. #### Response Example ```json { "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": [ { "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" ], "job_apply_link": "https://careers.united.com/us/en/job/WHQ00024243/Senior-Developer?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic" } ] } ``` ``` -------------------------------- ### Get Estimated Salaries for Jobs Source: https://www.openwebninja.com/api/jsearch/docs/index Retrieves estimated salary information for jobs based on title and location. It supports filtering by location type and years of experience, and allows projection of specific salary fields. The response includes salary details for various periods (hourly, daily, weekly, monthly, yearly) if available. ```Shell curl 'https://api.openwebninja.com/jsearch/estimated-salary?job_title=nodejs%20developer&location=new%20york&location_type=CITY&years_of_experience=LESS_THAN_ONE&fields=job_title%2Cmedian_salary%2Clocation' \ --header 'x-api-key: YOUR_SECRET_TOKEN' ``` -------------------------------- ### Perform Job Search (Shell) Source: https://www.openwebninja.com/api/jsearch/docs/index Executes a general job search query with various parameters to filter results. This endpoint allows searching for jobs based on keywords, location, country, employment type, experience level, and more. An API key is required for authentication. ```shell curl 'https://api.openwebninja.com/jsearch/search?query=developer%20jobs%20in%20chicago&page=1&num_pages=1&country=us&language=en&date_posted=today&work_from_home=false&employment_types=FULLTIME&job_requirements=no_experience&radius=1&exclude_job_publishers=BeeBe,Dice&fields=employer_name,job_publisher,job_title,job_country' \ --header 'x-api-key: YOUR_SECRET_TOKEN' ``` -------------------------------- ### Job Search API Source: https://www.openwebninja.com/api/jsearch/docs/index Perform general job searches with various filtering options. ```APIDOC ## GET /jsearch/search ### Description Search for jobs based on a query and various filtering parameters. ### Method GET ### Endpoint /jsearch/search ### Parameters #### Query Parameters - **query** (string) - Required - The search query for jobs (e.g., "developer jobs in chicago"). - **page** (integer) - Optional - The page number for the search results. Default: 1. - **num_pages** (integer) - Optional - The number of pages to retrieve. - **country** (string) - Optional - The country to search for jobs in (e.g., "us"). - **language** (string) - Optional - The language for the job search (e.g., "en"). - **date_posted** (string) - Optional - Filter jobs by when they were posted (e.g., "today"). - **work_from_home** (boolean) - Optional - Filter for remote work opportunities. Default: false. - **employment_types** (string) - Optional - Filter by employment type (e.g., "FULLTIME"). - **job_requirements** (string) - Optional - Filter by job requirements (e.g., "no_experience"). - **radius** (integer) - Optional - The search radius in miles. - **exclude_job_publishers** (string) - Optional - A comma-separated list of job publishers to exclude (e.g., "BeeBe,Dice"). - **fields** (string) - Optional - A comma-separated list of fields to include in the response (e.g., "employer_name,job_publisher,job_title,job_country"). ### Request Example ```curl https://api.openwebninja.com/jsearch/search?query=developer%20jobs%20in%20chicago&page=1&num_pages=1&country=us&language=en&date_posted=today&work_from_home=false&employment_types=FULLTIME&job_requirements=no_experience&radius=1&exclude_job_publishers=BeeBe,Dice&fields=employer_name,job_publisher,job_title,job_country ``` ### Response *Note: The response schema for the job search endpoint is not fully detailed in the provided text. The following includes common fields and structure.* #### Success Response (200) - **status** (string) - The status of the response. - **request_id** (string) - A unique identifier for the request. - **data** (array) - An array of job objects. - **employer_name** (string) - The name of the employer. - **job_publisher** (string) - The publisher of the job listing. - **job_title** (string) - The title of the job. - **job_country** (string) - The country where the job is located. *(Other fields may be returned based on the `fields` query parameter)* #### Response Example *A specific JSON response example for this endpoint was not provided in the input text. The following is a hypothetical example based on common job search API responses.* ```json { "status": "OK", "request_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef", "data": [ { "employer_name": "Tech Solutions Inc.", "job_publisher": "Indeed", "job_title": "Software Engineer", "job_country": "USA" } ] } ``` ``` -------------------------------- ### Company Job Salary API Source: https://www.openwebninja.com/api/jsearch/docs/index Retrieve estimated job salaries for a specific company, job title, and optionally location and experience level. ```APIDOC ## GET /jsearch/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 /jsearch/company-job-salary ### Parameters #### Query Parameters - **company** (string) - Required - The company name for which to get salary information (e.g. Amazon). - **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 (e.g. NY). - **location_type** (string) - Optional - Specify the type of the location for additional accuracy. Enum: ANY, CITY, STATE, COUNTRY. Default: ANY. - **years_of_experience** (string) - Optional - Get job estimation for a specific experience level range (years). Enum: ALL, LESS_THAN_ONE, ONE_TO_THREE, FOUR_TO_SIX, SEVEN_TO_NINE, TEN_TO_FOURTEEN, ABOVE_FIFTEEN. Default: ALL. ### Request Example ```curl https://api.openwebninja.com/jsearch/company-job-salary?company=Amazon&job_title=software%20developer&location=NY&location_type=CITY&years_of_experience=LESS_THAN_ONE ``` ### Response #### Success Response (200) - **status** (string) - The status of the response. - **request_id** (string) - A unique identifier for the request. - **data** (array) - An array of salary estimation objects. - **location** (string) - The location of the job posting. - **job_title** (string) - The title of the job. - **company** (string) - The name of the company. - **min_salary** (number) - The minimum estimated salary. - **max_salary** (number) - The maximum estimated salary. - **median_salary** (number) - The median estimated salary. - **min_base_salary** (number) - The minimum estimated base salary. - **max_base_salary** (number) - The maximum estimated base salary. - **median_base_salary** (number) - The median estimated base salary. - **min_additional_pay** (number) - The minimum estimated additional pay. - **max_additional_pay** (number) - The maximum estimated additional pay. - **median_additional_pay** (number) - The median estimated additional pay. - **salary_period** (string) - The period for the salary (e.g., YEAR). - **salary_currency** (string) - The currency of the salary (e.g., USD). - **confidence** (string) - The confidence level of the estimation. - **salary_count** (integer) - The number of salary data points used for estimation. #### Response Example ```json { "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 } ] } ``` ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.