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

# search_companies_by_description

> Companies that match a plain-language description, with a structured record for each. ₹0.79 per call for up to ten.

## What it does

Describe the companies you want in words ("Indian direct-to-consumer ayurvedic skincare brands founded after 2018"). Each row of `data.results[]` has `title`, `url` (the company's own site or a profile) and `entities[]` with the record found: name, description, location, industry, headcount range and founding year where known.

It takes a description, not filters. For filters such as headcount and funding use [`search_companies`](https://parel.si/docs/tools/search_companies.md), for companies like one you know use [`find_similar_companies`](https://parel.si/docs/tools/find_similar_companies.md).

India: put the place in the description. Small Indian brands are covered, with thinner records.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The company in words: what it does, its stage, where it is. |
| `numResults` | integer | no | How many companies, 1 to 10. Default 10.; min 1, max 10 |

## What drives the cost

Nothing you can turn: flat per call for up to ten results, so ask for ten (`numResults` above 10 is refused, free). A description that matches nothing real can still return near matches, and those are charged, so check them.

## Price today

| | |
|---|---|
| Price today | **₹0.79** per call (`cost_paise: 79`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹1.19 (`hold_paise: 119`); 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_by_description"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_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":"search_companies_by_description","input":{"query":"Indian direct-to-consumer ayurvedic skincare brands founded after 2018","numResults":10}}'
```

## What comes back

`data.results[]`. A real answer recorded during the live check of 2026-11-05, trimmed to two rows:

```json
{
  "results": [
    {
      "title": "The Tribe Concepts",
      "url": "https://thetribeconcepts.com/",
      "entities": [
        {
          "type": "company",
          "version": 1,
          "properties": {
            "name": "The Tribe Concepts",
            "foundedYear": 2019,
            "description": "A premium organic skin care brand who believes in the power of nature and the notes of Ayurveda. \n\nThe Tribe Concepts is a Truly Organic Skincare Brand. We work on the principle that pure organic extr…",
            "workforce": {
              "total": 22
            },
            "headquarters": {
              "address": "Bangalore, IN",
              "city": "Bengaluru",
              "postalCode": null,
              "country": "India"
            },
            "financials": null,
            "webTraffic": {
              "visitsMonthly": 42936,
              "countryRank": 49831,
              "avgDurationSeconds": 150,
              "history": [
                {
                  "value": 33909,
                  "dateFrom": "2026-05",
                  "dateTo": "2026-05"
                },
                {
                  "value": 30544,
                  "dateFrom": "2026-06",
                  "dateTo": "2026-06"
                },
                {
                  "value": 34130,
                  "dateFrom": "2026-07",
                  "dateTo": "2026-07"
                },
                {
                  "value": 27398,
                  "dateFrom": "2026-08",
                  "dateTo": "2026-08"
                },
                {
                  "value": 35535,
                  "dateFrom": "2026-09",
                  "dateTo": "2026-09"
                },
                {
                  "value": 42936,
                  "dateFrom": "2026-10",
                  "dateTo": "2026-10"
                }
              ]
            },
            "research": null
          }
        }
      ]
    },
    {
      "title": "Organiko-Beautifying Life",
      "url": "https://organiko.in/",
      "entities": [
        {
          "type": "company",
          "version": 1,
          "properties": {
            "name": "Organiko-Beautifying Life",
            "foundedYear": 2019,
            "description": "\nIntroducing Organiko – Beautifying Life, a socially responsible D2C skincare brand merging ancient Egyptian skincare secrets and Indian Ayurveda, harnessing the natural benefits of Donkey Milk. Our p…",
            "workforce": {
              "total": 5
            },
            "headquarters": {
              "address": "New Delhi, 110091, IN",
              "city": "New Delhi",
              "postalCode": null,
              "country": "India"
            },
            "financials": null,
            "webTraffic": {
              "visitsMonthly": 326,
              "countryRank": 551528,
              "avgDurationSeconds": 54,
              "history": [
                {
                  "value": 2115,
                  "dateFrom": "2026-05",
                  "dateTo": "2026-05"
                },
                {
                  "value": 1381,
                  "dateFrom": "2026-06",
                  "dateTo": "2026-06"
                },
                {
                  "value": 1065,
                  "dateFrom": "2026-07",
                  "dateTo": "2026-07"
                },
                {
                  "value": 1482,
                  "dateFrom": "2026-08",
                  "dateTo": "2026-08"
                },
                {
                  "value": 2414,
                  "dateFrom": "2026-09",
                  "dateTo": "2026-09"
                },
                {
                  "value": 2414,
                  "dateFrom": "2026-10",
                  "dateTo": "2026-10"
                }
              ]
            },
            "research": null
          }
        }
      ]
    }
  ]
}
```

## Notes

- Flat price per call for up to ten results; numResults above 10 is refused as invalid_input (free).
- Fields under entities[].properties vary by company, so check for nulls.
- No filters: put the place, size or stage in the description.

## Siblings

- [`search_companies`](https://parel.si/docs/tools/search_companies.md) to filter by headcount, funding and more.
- [`find_similar_companies`](https://parel.si/docs/tools/find_similar_companies.md) for companies like one you know.
- [`search_semantic`](https://parel.si/docs/tools/search_semantic.md) to describe any kind of page.
