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.
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
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:
{
"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_jobfor one posting in full.get_linkedin_companyfor the company hiring.
This page as Markdown: /docs/tools/search_jobs.md. Something wrong or missing: hello@parel.si.