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.

FieldTypeRequiredDescription
limitintegerno0-1000 rows; use 0 for aggregation-only requests. e.g. 1; max 10
cursorstringno
fieldsarray of stringnodot-path fields to include; always specify in production. e.g. ["job_details.title","job_details.url","company.basic_info.name"]
filtersobjectnoone 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "search_jobs"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_jobs"
Confirmationnot needed (the estimate is under the ₹200 threshold)
Count fieldlimit: 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

This page as Markdown: /docs/tools/search_jobs.md. Something wrong or missing: hello@parel.si.