> 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_backup

# list_companies_by_description_backup

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

## What it does

A second source for [`list_companies_by_description`](https://parel.si/docs/tools/list_companies_by_description.md), from a different data provider: a long list of companies that match a description: name, link and a summary each. Up to 100 per call. The answer is this provider's own, so its field names differ from [`list_companies_by_description`](https://parel.si/docs/tools/list_companies_by_description.md)'s: read the example answer, not [`list_companies_by_description`](https://parel.si/docs/tools/list_companies_by_description.md)'s docs.

Use it when [`list_companies_by_description`](https://parel.si/docs/tools/list_companies_by_description.md) fails or finds nothing; [`list_companies_by_description`](https://parel.si/docs/tools/list_companies_by_description.md) stays the first choice. It searches its own data, so it can find what the first source missed. It is a separate call at its own price: it is billed per call when it answers; a failed or empty call is free.

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-18.

| Field | Type | Required | Description |
|---|---|---|---|
| `page` | integer | no | 1-based page number; page * pageSize may not exceed 10,000 — past that use the scroll route. e.g. 1 |
| `type` | array of string | no | private, public, nonprofit, educational, government |
| `lists` | array of integer | no | restrict to saved list ids (dashboard feature, plan-gated) |
| `cities` | array of integer | no |  |
| `expand` | array of string | no | expensive on a search |
| `states` | array of integer | no |  |
| `exclude` | object | no | domains/companies to drop; the per-search exclude cap is plan-bound (500 Starter → 50,000 Scale) |
| `regions` | array of string | no |  |
| `require` | array of string | no | features that MUST be present on the company record |
| `revenue` | array of string | no | revenue buckets, e.g. over-1b |
| `category` | array of string | no | b2b, b2c, b2g, saas, marketplace, service-provider … |
| `keywords` | array of string | no | description keywords; resolve them first with the free /keywords/autocomplete |
| `countries` | array of string | no | ISO 3166-1 alpha-2 codes. e.g. ["US"] |
| `employees` | array of string | no | employee-count buckets, e.g. 1-10, 5K-10K, over-10K |
| `naicsCode` | array of integer | no | 2-6 digit NAICS; a short code matches all its children |
| `objective` | string | one of | free-text match on company name and domain, max 250 chars |
| `foundedYear` | object | no | range object, e.g. {min: 2015, max: 2022} |
| `fundingYear` | object | no | range object |
| `match_limit` | integer | no | 1-100, default 10. THIS IS THE PRICE. e.g. 1; max 10 |
| `technologies` | array of string | no | technology-stack names; resolve them first with the free /technologies/autocomplete. e.g. ["stripe"] |
| `fundingAmount` | object | no | range object in USD |
| `fundingRounds` | array of string | no | seed, debt_financing, angel, venture, series_a, series_b, series_c, series_d, series_e, series_f, series_g, series_h, other; hyphen forms like series-a are rejected. e.g. ["series_a"] |
| `semanticQuery` | string | no | natural-language description of the companies you want. e.g. "companies that sell payment infrastructure to developers" |
| `workforceSize` | array of object | no | absolute headcount ranges, finer-grained than the buckets |
| `semanticWeight` | number | no | 0-1, default 0.7 — higher favours semantic similarity over the structured filters |
| `workforceGrowth` | object | no | filter by headcount growth rate over a window |
| `categoryOperator` | string | no | and \| or — how multiple `category` values combine |
| `keywordsOperator` | string | no | and \| or |
| `reportedEmployees` | array of string | no | same buckets, but the externally reported figure |
| `technologiesOperator` | string | no | and \| or |

One of these sets must be complete (anything else is `invalid_input`, ₹0): `objective`.

## What drives the cost

Flat price per call. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹1.11** per result (`cost_paise: 111`) at ₹93.93 per US dollar on 17 November 2026; each one asked for is charged, ₹11 for the largest call |
| Hold before the call | ₹1.67 (`hold_paise: 167`) for one, ₹16.58 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: "list_companies_by_description_backup"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "list_companies_by_description_backup"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |
| Count field | `match_limit`: The hold covers the number of results you ask for in match_limit; leave it out and the worst case is held. |

## 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_backup","input":{"objective":"D2C skincare brands in India selling ayurvedic products online","match_limit":10}}'
```

## What comes back

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

```json
{
  "items": [
    {
      "id": "0192547a-0d7f-72b3-b2de-68b3296dd8d8",
      "name": "Yogi Ayurvedic Products",
      "domain": "yogiindia.com",
      "website": "https://yogiindia.com",
      "type": null,
      "legalName": null,
      "industry": "Manufacturing",
      "industries": [
        "Manufacturing/Pharmaceuticals",
        "Retail/Drug Stores & Pharmacies"
      ],
      "categories": [
        "b2c"
      ],
      "employees": "1-10",
      "reported_employees": "1-10",
      "revenue": null,
      "description": "Yogi Ayurvedic Products Pvt. Ltd. is an Indian manufacturer and supplier of over-the-counter Ayurvedic products. Based in Nashik, Maharashtra, the company has been operating for about 20 years and distributes through thousands of outlets ac…",
      "keywords": [
        "ayurvedic medicine manufacturing",
        "otc ayurvedic products",
        "traditional indian medicine"
      ],
      "technologies": [
        "Apache",
        "Bootstrap Framework",
        "Google translate API"
      ],
      "subsidiaries": null,
      "founded_year": null,
      "naics_codes": [
        "325412",
        "325411",
        "424210"
      ],
      "location": {
        "country": {
          "code": "IN",
          "name": "India",
          "latitude": 20,
          "longitude": 77
        },
        "state": {
          "id": 1652,
          "name": "Maharashtra",
          "code": "MH",
          "latitude": 19.75148,
          "longitude": 75.71389
        },
        "city": {
          "id": 47122,
          "name": "Nashik",
          "latitude": 19.99727,
          "longitude": 73.79096
        },
        "address": "C-16, NICE, MIDC Satpur, Nashik 422007, Maharashtra, INDIA",
        "postal_code": null,
        "phone": "+91-9876543210"
      },
      "financial": {
        "stock_symbol": null,
        "stock_exchange": null,
        "total_funding": null,
        "funding_stage": null,
        "funding_date": null,
        "funding": null
      },
      "socials": {
        "linkedin_url": "https://www.linkedin.com/company/shri-rang-kisanlal-sarda-yogi-ayurvedic-private-limited",
        "linkedin_id": "7030823",
        "twitter_url": null,
        "facebook_url": null,
        "instagram_url": null,
        "angellist_url": null,
        "crunchbase_url": null,
        "youtube_url": null,
        "github_url": null,
        "g2_url": null
      },
      "page_rank": 0.4011366,
      "seo_description": "yogi ayurvedic products pvt. ltd. is a company based out of India.",
      "updated_at": "2026-11-15T08:16:32.169344Z"
    },
    {
      "id": "019cfedc-a5a8-74ff-be14-8939a2b3ab72",
      "name": "D2C Guru",
      "domain": "d2c.guru",
      "website": "https://d2c.guru",
      "type": null,
      "legalName": null,
      "industry": "Retail",
      "industries": [
        "Retail/Consumer Electronics & Computers Retail",
        "Business Services/Advertising & Marketing"
      ],
      "categories": [
        "b2c",
        "e-commerce"
      ],
      "employees": null,
      "reported_employees": null,
      "revenue": null,
      "description": "D2C Guru is a directory and marketplace that aggregates direct-to-consumer brands, highlighting newly launched products across categories. The platform showcases diverse Indian and global D2C brands spanning beauty, snacks, spiritual access…",
      "keywords": [
        "clean beauty brands india",
        "refillable cosmetics",
        "vegan friendly snacks"
      ],
      "technologies": [],
      "subsidiaries": null,
      "founded_year": null,
      "naics_codes": [
        "454110",
        "519130"
      ],
      "location": {
        "country": null,
        "state": null,
        "city": null,
        "address": null,
        "postal_code": null,
        "phone": null
      },
      "financial": {
        "stock_symbol": null,
        "stock_exchange": null,
        "total_funding": null,
        "funding_stage": null,
        "funding_date": null,
        "funding": null
      },
      "socials": {
        "linkedin_url": null,
        "linkedin_id": null,
        "twitter_url": null,
        "facebook_url": null,
        "instagram_url": "https://instagram.com/d2c.guru",
        "angellist_url": null,
        "crunchbase_url": null,
        "youtube_url": null,
        "github_url": null,
        "g2_url": null
      },
      "page_rank": 0,
      "seo_description": null,
      "updated_at": "2026-11-14T03:12:11.116262Z"
    },
    {
      "id": "019249f5-5dcd-7ec7-852c-e0d34c230ce1",
      "name": "Kairali Ayurvedic Products",
      "domain": "kairaliproducts.com",
      "website": "https://kairaliproducts.com",
      "type": "private",
      "legalName": null,
      "industry": "Retail",
      "industries": [
        "Retail/Consumer Electronics & Computers Retail",
        "Manufacturing/Pharmaceuticals",
        "Manufacturing/Chemicals & Related Products"
      ],
      "categories": [
        "b2c",
        "e-commerce"
      ],
      "employees": "501-1K",
      "reported_employees": null,
      "revenue": null,
      "description": "Kairali Ayurvedic Products Private Limited operates an online store and product line focused on Ayurvedic and herbal wellness solutions. The company offers a range of skincare, hair care, general health, women's and men's health products, a…",
      "keywords": [
        "ayurvedic skincare",
        "kumkumadi oil",
        "ayurvedic hair oil"
      ],
      "technologies": [
        "Gmail",
        "Google Apps",
        "DigitalOcean"
      ],
      "subsidiaries": null,
      "founded_year": 1989,
      "naics_codes": [
        "454110",
        "325411",
        "325199"
      ],
      "location": {
        "country": {
          "code": "IN",
          "name": "India",
          "latitude": 20,
          "longitude": 77
        },
        "state": {
          "id": 1662,
          "name": "Tamil Nadu",
          "code": "TN",
          "latitude": 11.127123,
          "longitude": 78.65689
        },
        "city": {
          "id": 48046,
          "name": "Pollachi",
          "latitude": 10.65825,
          "longitude": 77.0085
        },
        "address": "KAPPL - Pollachi",
        "postal_code": "110001",
        "phone": "+91 98765 43210"
      },
      "financial": {
        "stock_symbol": null,
        "stock_exchange": null,
        "total_funding": null,
        "funding_stage": null,
        "funding_date": null,
        "funding": null
      },
      "socials": {
        "linkedin_url": null,
        "linkedin_id": null,
        "twitter_url": "https://twitter.com/Kairali_Group",
        "facebook_url": "https://www.facebook.com/KairaliAyurvedicProducts",
        "instagram_url": "https://www.instagram.com/kairali_ayurvedic_products",
        "angellist_url": null,
        "crunchbase_url": null,
        "youtube_url": "https://www.youtube.com/user/kairaliayurvedagroup",
        "github_url": null,
        "g2_url": null
      },
      "page_rank": 1.5042623,
      "seo_description": "Kairali is a leading manufacturer and exporter of ayurvedic herbal products and cosmetic products. Purchase herbal health and beauty products at an affordable price.",
      "updated_at": "2026-11-05T13:25:54.121291Z"
    }
  ],
  "page": 1,
  "totalPages": 1000,
  "totalItems": 10000
}
```

## Notes

- Second source for list_companies_by_description: call list_companies_by_description first, this one after a failure or an empty answer.
- Field names differ from list_companies_by_description's; inputs keep list_companies_by_description's names where they mean the same thing.

## Siblings

- [`list_companies_by_description`](https://parel.si/docs/tools/list_companies_by_description.md)
