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

# search_companies

> Companies by industry, size, revenue, type, location or keyword: name, website, headcount and industry per row. ₹4.29 for the largest call (100 rows); you pay per row returned, and no rows is ₹0.

## What it does

Companies matching a `query` of filters (industry, location, keyword, type, name, headcount and revenue ranges, headcountGrowth; each `{include: [...], exclude: [...]}`), in `data.leads[]` with `name`, `description`, `website`, `numberOfEmployees`, `headcountRange`, `industry`, `foundedYear`, `type`, `address` and the LinkedIn `url`, with `data.total` and `data.pagination.token` for the next page. Use it to build a prospect list; for one company [`get_linkedin_company`](https://parel.si/docs/tools/get_linkedin_company.md), for the people inside it [`search_linkedin_people`](https://parel.si/docs/tools/search_linkedin_people.md).

India: `location: {include: ["Bengaluru"]}` or `["India"]`; industry names follow LinkedIn's list ("Food & Beverages").

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `query` | object | yes | filter object: name, lid (profile vanity id), urn (numeric id), companyId (domain / URN / profile URL / vanity name), type (Privately Held, Public Company, Nonprofit, …), industry, location, keyword — each {include: [...], exclude: [...]}; headcount and revenue take ranges like {">": 10}; headcountGrowth takes {min, max, timespan: 6months\|12months\|24months}. e.g. {"companyId":{"include":["stripe.com"]}} |
| `pagination` | object | no | {size, token}. size is how many companies to return, 1 to 200 (default 100); each row returned is charged, so a size above 100 costs more than the price shown. token is the pagination token of the previous answer, for the next page. |

## What drives the cost

The number of rows returned. The source charges per row, so the price shown is for the largest call (`pagination.size` 100, the default); the charge settles at rows × about a twentieth of it. `{"size": 10}` costs about a tenth. No rows is `class: "ok_free"`, ₹0.

## Price today

| | |
|---|---|
| Price today | **₹4.29** per call (`cost_paise: 429`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹6.44 (`hold_paise: 644`); 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_companies"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_companies"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_companies","input":{"query":{"industry":{"include":["Food & Beverages"]},"location":{"include":["Bengaluru"]}},"pagination":{"size":10}}}'
```

## What comes back

`data.leads[]`, `data.total`, `data.pagination`. A real answer recorded during the live check of 2026-10-28, trimmed to two rows:

```json
{
  "total": 139,
  "success": true,
  "leads": [
    {
      "name": "Dwarkamai Oil Mills",
      "lid": "dwarkamai-oil-mills",
      "urn": "urn:li:fs_salesCompany:51710068",
      "url": "https://www.linkedin.com/company/dwarkamai-oil-mills/",
      "description": "We Offer Natural Wood Pressed Oils... From our Mills directly to your house freshly grounded post receiving your orders... YES YOU HEARD IT RIGHT POST RECEIVING YOUR ORDERS !!!\nSo you get to savor the fresh Oil not the ones with preservatives or the ones stored for months.\n\nAND YES WE DELIVER IT FOR FREE !",
      "address": "75 Bommasandra Main Road Police Layout, 560099, Bengaluru, Karnataka, India",
      "numberOfEmployees": 0,
      "headcountRange": {
        "lte": 1
      },
      "industry": "Food & Beverages",
      "foundedYear": 2019,
      "type": "Sole Proprietorship",
      "website": "https://dwarkamaiproducts.com/",
      "slogan": "We Offer Natural Wood Pressed Oils... From our Mills directly to your house freshly grounded post receiving your orders.",
      "specialties": [
        {
          "value": "We deliver Free anywhere in Bengaluru"
        },
        {
          "value": "Hygenically Processed "
        },
        "… 3 more item(s) truncated"
      ],
      "estimatedRevenuRange": {
        "estimatedMinRevenue": {
          "amount": 0,
          "unit": "ONE",
          "currency": "USD"
        },
        "estimatedMaxRevenue": {
          "amount": 500,
          "unit": "THOUSAND",
          "currency": "USD"
        }
      },
      "employeeGrowth": [],
      "phone": "9876543210",
      "_id": "urn:li:fs_salesCompany:51710068"
    },
    {
      "name": "Shree Kandhan Stores - India",
      "lid": "shree-kandhan-stores---india",
      "urn": "urn:li:fs_salesCompany:7874276",
      "url": "https://www.linkedin.com/company/shree-kandhan-stores---india/",
      "description": "Shree Kandhan Stores - India is a food & beverages company based out of Ramamurthy Nagar Address 333, Ramamurthy Nagar Main Road City, Bangalore, Karnataka, India.",
      "address": "Bengaluru, Karnataka, India",
      "numberOfEmployees": 1,
      "industry": "Food & Beverages",
      "website": "http://shreekandhanstores.com",
      "specialties": [],
      "employeeGrowth": [],
      "phone": "",
      "_id": "urn:li:fs_salesCompany:7874276"
    },
    "… 8 more item(s) truncated"
  ],
  "pagination": {
    "token": "eyJzYSI6W1sxODExMF0sWzYxOTQ2OTZdXSwiaWQiOiJnTHVLQkE4d2FXTjVjR1ZoY3kxemJuTXRjSEp2WkhWamRHbHZiaTFzYVc1clpXUnBiaTFqYjIxd1lXNTVMVEl3TWpZd056STBGakpGVmpkcWJUVlNVa0ZITlV4VFZYcEpkemQwV0djQUZucDNTSFpWYm1jNVVpMWxXRU00V1hJMVFuZ3dPRkVBQUFBQUFIS3IxVGdXWlZoaE5FRm5UMmRSYkV0clJHcDNWRTk1UjFCeVp3QXdhV041Y0dWaGN5MXpibk10Y0hKdlpIVmpkR2x2Ymkxc2FXNXJaV1JwYmkxamIyMXdZVzU1TFRJd01q…",
    "size": 10
  }
}
```

## Notes

- Charged per row returned (about a twentieth of the shown price each); the shown price is the maximum, at size 100. Set pagination {size: 10} for a cheap first look.
- Filter values follow LinkedIn's industry and company-type names.
- Pass pagination.token from the response for the next page.

## Siblings

- [`get_linkedin_company`](https://parel.si/docs/tools/get_linkedin_company.md) to read one of them in full.
- [`domain_search`](https://parel.si/docs/tools/domain_search.md) for the emails at one of them.
