# Company search

> Find companies by description, industry, technology or country.

`company_search` finds companies by what they do, their industry or the technology they use, for example “open source vector databases”, or industry “fintech” in country “DE”. It returns each company’s name, domain, description, industry, size and location where known. Give at least one of `query`, `industry` or `technology`. To look up one company you already know, use [`company_enrich`](https://clonvo.com/docs/company-enrich.md).

Call it with `POST /v1/tools/company_search`, or as `company_search` over [MCP](https://clonvo.com/docs/mcp.md).

## Arguments

-   `query` string
    
    The companies to find, described in words.
    
-   `industry` string
    
    An industry, e.g. "fintech" or "biotechnology".
    
-   `technology` string
    
    A technology the companies use, e.g. "Snowflake" or "Shopify".
    
-   `country` string
    
    ISO 3166-1 alpha-2 country code, e.g. "US" or "DE".
    
-   `max_results` integer
    
    How many companies to return (1–25, default 10).
    

## Example

```bash
curl https://api.clonvo.com/v1/tools/company_search \
  -H "Authorization: Bearer $CLONVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "arguments": { "query": "open source vector databases", "max_results": 2 } }'
```

```json
{
  "id": "gen-01M6A3B5D7F9H1K3M5P7R9T1V3",
  "tool": "company_search",
  "provider": "clonvo",
  "result": {
    "companies": [
      {
        "name": "Qdrant",
        "domain": "qdrant.tech",
        "website": "https://qdrant.tech",
        "description": "Qdrant is an open-source vector database and vector search engine…",
        "industry": "Software Development",
        "employees": "51-200",
        "location": "Berlin, Germany",
        "founded": 2021,
        "linkedin_url": "https://www.linkedin.com/company/qdrant"
      },
      {
        "name": "Weaviate",
        "domain": "weaviate.io",
        "website": "https://weaviate.io",
        "description": "Weaviate is an open-source, deployment-agnostic vector database platform…",
        "industry": null,
        "employees": "73",
        "location": "Amsterdam, Netherlands",
        "founded": 2019,
        "linkedin_url": null
      }
    ]
  },
  "usage": { "cost": 0.012, "charged": 0.01224, "is_byok": false }
}
```

## Result

| Field | Description |
| --- | --- |
| `companies[]` | The companies found, each with the [company fields](#company-fields) below. |
| `notes` | Present when the provider handled an argument differently, for example a filter it couldn’t apply. |

The fields around `result` (`id`, `tool`, `provider`, `usage`) are the same for every tool; see [Calling tools](https://clonvo.com/docs/calling-tools.md#response).

## Company fields

Every company tool returns companies with these fields, whichever provider found them. A field the provider doesn’t know is `null`.

| Field | Description |
| --- | --- |
| `name` | The company’s name. Always set. |
| `domain` | Its website domain, such as `qdrant.tech`. |
| `website` | Its website URL. |
| `description` | What the company does. |
| `industry` | Its industry. |
| `employees` | Headcount or a range, as a string, as the provider states it (`"51-200"`, `"250"`). |
| `location` | Where it’s based. |
| `founded` | The year it was founded, as a number. |
| `linkedin_url` | Its LinkedIn company page. |

Clonvo never returns email addresses or phone numbers, even when a provider sends them.

## Notes

-   Results can differ slightly between providers: field coverage depends on the provider that served the call, and a filter it can’t apply is listed in `notes`.
-   Some providers price company searches per result returned, so `max_results` affects the cost. On Clonvo credits the cap for the call grows with `max_results`; see [Tool billing](https://clonvo.com/docs/tool-billing.md#on-clonvo-credits).
-   Company and people lookups are never stored as [web tool queries](https://clonvo.com/docs/privacy.md#web-tool-queries).