> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_jobs

# search_jobs

> Job postings by company, title, location or funding filters: title, link, location and company per row. ₹1.02 per job returned; no matches is ₹0.

## What it does

Job postings matching `filters` (one condition `{field, type, value}` or a nested group), in `data.job_listings[]` with `job_details` (title, url, category, posted date), `location` and `company` (name, domain), with `data.total_count` and `data.next_cursor`. `fields` names the dot-paths you want; `limit` is how many jobs you pay for (up to 10 here). Use it to read hiring as a signal; for one LinkedIn posting in full [`get_linkedin_job`](https://parel.si/docs/tools/get_linkedin_job.md).

India: filter on `location` with type `=` or `in`, or on `company.basic_info.name`.

## Inputs

Generated from the contract captured from staging on 2026-11-05. This tool is priced per job: the hold follows `limit`.

| Field | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | no | 0-1000 rows; use 0 for aggregation-only requests. e.g. 1; max 10 |
| `cursor` | string | no |  |
| `fields` | array of string | no | dot-path fields to include; always specify in production. e.g. ["job_details.title","job_details.url","company.basic_info.name"] |
| `filters` | object | no | one condition or nested condition group |

## What drives the cost

`limit`: the source charges per job returned, so the hold is `limit` × the unit price (ten at most) and the charge settles at the rows that came back. No matches is `class: "ok_free"`, ₹0. An unknown field name is a free `vendor_error` that lists the valid ones.

## Price today

| | |
|---|---|
| Price today | **₹1.02** per job (`cost_paise: 102`) at ₹93.93 per US dollar on 17 November 2026; each one asked for is charged, ₹10 for the largest call |
| Hold before the call | ₹1.53 (`hold_paise: 153`) for one, ₹15.23 for the largest call; when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_jobs"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_jobs"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |
| Count field | `limit`: The hold covers the number of results you ask for in limit; leave it out and the worst case is held. |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_jobs","input":{"limit":5,"fields":["job_details.title","job_details.url","location","company.basic_info.name"],"filters":{"type":"=","field":"company.basic_info.name","value":"Zomato"}}}'
```

## What comes back

`data.job_listings[]`, `data.total_count`, `data.next_cursor`. A real answer recorded during the live check of 2026-10-28, trimmed to two jobs:

```json
{
  "job_listings": [
    {
      "company": {
        "basic_info": {
          "name": "Zomato"
        }
      },
      "job_details": {
        "title": "Key Accounts Manager - Acquisition",
        "url": "https://in.indeed.com/viewjob?jk=a3c7941e99a5421a"
      },
      "location": {
        "city": "Mumbai",
        "country": "India",
        "district": "Konkan Division",
        "pincode": null,
        "raw": "Mumbai, Maharashtra",
        "state": "Maharashtra"
      }
    },
    {
      "company": {
        "basic_info": {
          "name": "Zomato"
        }
      },
      "job_details": {
        "title": "Customer Delight Associate",
        "url": "https://www.linkedin.com/jobs/view/4274217759"
      },
      "location": {
        "city": "Hyderabad",
        "country": "India",
        "district": null,
        "pincode": null,
        "raw": "Hyderabad, Telangana, India",
        "state": "Telangana"
      }
    },
    "… 3 more item(s) truncated"
  ],
  "next_cursor": "H4sIAL_l4WoC_xWMOQrDMBQFryJUu9DfpVwlBCPJMi5CRLwUIeTusV85zLyvfx9t_YxL3hZ_c15YOE8JoGoNGLQAmjJkmhMbxgJpzkWnXGrlRoqTtMIUgJCMSIMfnN_6up9fdzBMEZjDtcEJKKOBickJER6nuvc9P8faj9dVSPz9AeBfAveQAAAA",
  "total_count": 58
}
```

## Notes

- Priced per job: limit (max 10 here) is what you pay for; no matches is free.
- Always pass fields; an unknown field is a free vendor error that lists the valid ones.
- Filters: {field, type (=, in, (.), >), value} or {op: and|or, conditions: [...]}.

## Siblings

- [`get_linkedin_job`](https://parel.si/docs/tools/get_linkedin_job.md) for one posting in full.
- [`get_linkedin_company`](https://parel.si/docs/tools/get_linkedin_company.md) for the company hiring.
