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

# list_companies_by_description

> A long list of companies that match a description: name, link and a summary each. Up to 100 per call. ₹0.57 per call; a result that finds nothing is ₹0.

## What it does

Up to a hundred companies that match a description in plain words, as data[] with name, url (usually a LinkedIn company page or a company database entry) and description, a paragraph of what is known: sector, location, website, headcount where found.

Use it when you want the long list rather than ten rich records: [`search_companies_by_description`](https://parel.si/docs/tools/search_companies_by_description.md) returns ten with headcount, revenue and funding as fields, [`search_companies`](https://parel.si/docs/tools/search_companies.md) filters by industry and size, [`enrich_company`](https://parel.si/docs/tools/enrich_company.md) fills one company in from its domain. Flat price per call whatever match_limit says (1 to 100); an empty list is free. Three to five seconds; about 70 KB for fifty companies, so over MCP the list is cut to whole entries with a note.

India: Indian companies are well covered; say India or the city in the objective. In the live check fifty ayurvedic skincare brands came back for one call.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `objective` | string | yes | The companies in words: product, stage, industry, location. |
| `match_limit` | integer | no | How many companies at most, 1 to 100. Default 100.; min 5, max 100 |

## What drives the cost

Flat per call for up to 100 companies; set match_limit for fewer. A description almost always matches something, so judge the entries against it. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.57** per call (`cost_paise: 57`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.86 (`hold_paise: 86`); 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: "list_companies_by_description"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "list_companies_by_description"` |
| 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":"list_companies_by_description","input":{"objective":"D2C skincare brands in India selling ayurvedic products online","match_limit":50}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
[
  {
    "name": "VedicDerm",
    "url": "https://platform.tracxn.com/a/d/company/60ce8a8b188f531dc59e4e3b/vedicderm?utm_source=parallel&utm_medium=ai#a:about",
    "description": "Name: VedicDerm | Website Url: https://vedicderm.com | Primary Sector: Consumer Goods | Primary Subsector: Beauty & Personal Care Products | Stage: Unfunded | Founded Year: 2021 | Location Country: India | Location State: Haryana | Location…"
  },
  {
    "name": "IVedic",
    "url": "https://linkedin.com/company/ivedic-ayurscience",
    "description": "Name: IVedic | Website Url: https://ivediclife.com | Primary Sector: Retail | Primary Subsector: Beauty Tech | Stage: Unfunded | Founded Year: 2023 | Employee Count Official: 5 | Location Country: India | Location State: Gujarat | Location…"
  },
  {
    "name": "Twak Ayurveda",
    "url": "https://platform.tracxn.com/a/d/company/5e1b363f07582b579e359231/twak%20ayurveda?utm_source=parallel&utm_medium=ai#a:about",
    "description": "Name: Twak Ayurveda | Website Url: http://twakayurveda.com | Primary Sector: Retail | Primary Subsector: Beauty Tech | Stage: Deadpooled | Founded Year: 2020 | Location Country: India | Location State: Maharashtra | Location City: Pune | Ac…"
  }
]
```

## Notes

- Flat per call for up to 100 companies; set match_limit for fewer. A description almost always matches something, so judge the entries against it.
- Each entry is name, url and a text summary, not structured fields: for headcount and funding as fields use search_companies_by_description or enrich_company.
- About 70 KB for fifty companies: over MCP whole entries are dropped from the end to fit, with a _truncated note.

## Siblings

- [`search_companies_by_description`](https://parel.si/docs/tools/search_companies_by_description.md)
- [`search_companies`](https://parel.si/docs/tools/search_companies.md)
- [`enrich_company`](https://parel.si/docs/tools/enrich_company.md)
