---
title: "Job Search"
method: POST
path: "/v1/data/jsearch"
tags: ["Data"]
---

# Job Search

`POST /v1/data/jsearch`

## Request

- Base URL: `https://apipie.ai`
- URL: `https://apipie.ai/v1/data/jsearch`
- Auth: API key in header `Authorization`

Search for jobs using JSearch API through RapidAPI

## Request body

- JSearchRequest
  - `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: Page to return (each page includes up to 10 results)
  - `num_pages` integer: Number of pages to return, starting from page
  - `country` string: Country code of the country from which to return job postings
  - `language` string: Language code in which to return job postings
  - `date_posted` 'all' | 'today' | '3days' | 'week' | 'month': Find jobs posted within the time you specify
  - `work_from_home` boolean: Only return work from home / remote jobs
  - `employment_types` string: Find jobs of particular employment types, specified as a comma delimited list
  - `job_requirements` string: Find jobs with specific requirements, specified as a comma delimited list
  - `radius` integer: Return jobs within a certain distance from location (in km)
  - `exclude_job_publishers` string: Exclude jobs published by specific publishers, specified as a comma separated list
  - `fields` string: A comma separated list of job fields to include in the response
  - `user` string: User identifier for billing observability purposes

## Response `200`

Successful job search with results

- JSearchResponse
  - `dataResults` object
    - `jobs` JobResultItem[]
      - `employer_name` string
      - `employer_logo` string
      - `job_publisher` string
      - `job_id` string
      - `job_employment_type` string
      - `job_title` string
      - `job_apply_link` string
      - `job_description` string
      - `job_is_remote` boolean
      - `job_posted_at_timestamp` integer
      - `job_city` string
      - `job_state` string
      - `job_country` string
      - `rank` integer
    - `general` object
      - `query` string
      - `results_cnt` integer
      - `total_jobs` integer
      - `page` integer
      - `num_pages` integer
  - `queryDetails` JSearchUsage
    - `search_id` string
    - `timestamp` integer
    - `keywords` string
    - `requested_records` integer
    - `total_records` integer
    - `cost` number, float
    - `latency` integer

## Other responses

- `400`: Bad request or search failed
- `401`: Unauthorized - invalid API key
- `402`: Insufficient credits
- `500`: Internal server error

---

[API](https://skmtc.dev/apipie/apis/introduction.md) · [All operations](https://skmtc.dev/apipie/apis/introduction/llms.txt) · [OpenAPI document](https://skmtc.dev/apipie/apis/introduction/revisions/f8386be4eb3f?raw)