> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seamless.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Name → Website

> Get the website domain for a list of company names, with industry, size, and location to confirm the match.

> [!NOTE]
>
> **Endpoint** `POST /search/companies` with `companyName` · **Credits** charged per results returned · **Versions** v1, v2

## Introduction

Send company names and get back each company's website domain, along with industry, headcount, revenue, and headquarters location so you can confirm the match. Use it to normalize CRM accounts, match trade show lists, and turn company names into domains for other lookups.

Tune the matching with `companyNameSearchType`:

| Value | Behavior |
| - | - |
| `default` | Standard relevance matching |
| `exact` | Exact company name only. Best for clean lists. |
| `related` | Also matches subsidiaries, parent companies, and brand aliases |

Results are ordered by relevance, so the first row is the best match. When you send several names, read each row's `companyName` to pair it with your input.

## AI agent prompt

```text theme={null}
Read https://docs.seamless.ai/llms.txt and https://docs.seamless.ai/api-catalog/company-name-to-website.
Using my Seamless.AI API key from SEAMLESS_API_KEY, for each company name in my list call
POST https://api.seamless.ai/api/client/v1/search/companies with
{"companyName": [<name>], "companyNameSearchType": "exact", "limit": 1}
and return a table of name -> domain, industry, companySize, city, state.
```

## Authentication

Send your API key in the `Token` header, or `Authorization: Bearer <token>` with [OAuth](https://docs.seamless.ai/authentication/oauth.md). Create a key under [Settings → Public API](https://docs.seamless.ai/authentication/api-keys.md).

## Example

```bash theme={null}
curl -X POST https://api.seamless.ai/api/client/v1/search/companies \
  -H "Token: $SEAMLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": ["Seamless.AI"],
    "companyNameSearchType": "exact",
    "limit": 1
  }'
```

For Python, JavaScript, and other languages, see [Search companies](https://docs.seamless.ai/api-reference/v1/company-search/search-companies.md) in the API reference.

## Reference

| Parameter | Type | Required | Description |
| - | - | - | - |
| `companyName` | string\[] | Yes | Company names to match. Use this when you know full company names or key name fragments. |
| `companyNameSearchType` | string | No | Matching strategy for `companyName` (`default` = standard matching, `related` = include aliases/related names, `exact` = exact company name only). Default `default`. |
| `companyCountry` | string\[] | No | Company location country filters. Narrows `companyState` rather than widening it, so `companyState: ["Virginia"]` with `companyCountry: ["United States"]` returns Virginia companies only. A state and country that do not belong together narrow to nothing: `companyState: ["Texas"]` with `companyCountry: ["Germany"]` matches no companies, since no company is in both — that pair comes back under `warnings` too, suggesting the state's real country. Use `locations` when you mean either place rather than both. It does not narrow `locations` — put the country inside the tag itself (`"Austin, Texas, United States"`) to scope a free-form value. Prefix a value with `-` to exclude it; an excluded country stands alone and narrows nothing. `"US"`, `"USA"` and `"United States of America"` all resolve to the United States. Use `GET /search/locations?types=country` to find any other country's spelling; a value the vocabulary does not hold matches no companies and comes back under `warnings`, with suggestions, rather than as an error. Up to 10 values. |
| `companyState` | string\[] | No | Company location state filters. Accepts a US state name or abbreviation and non-US subdivisions alike (`"CA"`, `"California"`, `"Ontario"`). A company matches if it is in any of these states, narrowed by `companyCountry` when that is supplied too. Prefix a value with `-` to exclude it; an excluded state stands alone, since exclusions narrow on their own. Values match a fixed vocabulary of place names spelled the way our data spells them, which is usually the English exonym — Germany's state is `"Bavaria"`, not `"Bayern"`. US state names and abbreviations are both resolved, so neither needs a lookup. Use `GET /search/locations` to find the spelling for anything else; a value the vocabulary does not hold matches no companies and comes back under `warnings`, with suggestions, rather than as an error. Up to 10 values. |
| `limit` | integer | No | Number of companies to return per page before credit-based trimming is applied. A larger value is reduced to 500 rather than rejected. Default `50`. |

**Allowed values for `companyNameSearchType`:** `default`, `related`, `exact`

Most list filters also have a per-account limit on how many values one request can send, which can be lower than any maximum above. A request over it returns `400` with `invalidArguments`, naming the filter and its limit.

Use `companyCountry` or `companyState` to narrow an ambiguous name. Send one name with `limit: 1` to get only its best match.

## Response

| Field | Description |
| - | - |
| `domain` | Primary website domain |
| `companyName` | Canonical company name |
| `industries`, `companySize`, `companyRevenue` | Firmographics to confirm the match |
| `city`, `state`, `country` | Headquarters location |
| `liUrl` | LinkedIn company page |
| `searchResultId` | Pass to [Company Research](https://docs.seamless.ai/api-catalog/company-enrichment.md) for the full record |

## Errors

| Status | Meaning |
| - | - |
| `400` | Invalid request |
| `401` | Missing or invalid API key |
| `422` | `insufficientCredits` or `missingApiAccess` |
| `429` | Rate limit reached |

## Related

* [Website → Company Profile](https://docs.seamless.ai/api-catalog/website-to-company-profile.md)
* [Company Name filter](https://docs.seamless.ai/api-catalog/company-search.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.