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

# Website → Company Profile

> Turn a website URL or domain into a full company profile: firmographics, phones, headquarters address, technologies, funding, and news.

> [!NOTE]
>
> **Endpoint** `POST /companies/research` · **Credits** 1 per company · **Delivery** async (poll or webhook) · **Versions** v1, v2

## Introduction

Send a website domain and get back the company behind it: name, description, industry and SIC/NAICS codes, headcount, revenue, company phones with confidence scores, headquarters address, top technologies, funding, and recent news. Use it to enrich form fills, score inbound accounts, and fill gaps in CRM account records.

Send up to 500 domains per request. Pass the root domain without `https://` or a path, for example `acme.com`.

## AI agent prompt

```text theme={null}
Read https://docs.seamless.ai/llms.txt and https://docs.seamless.ai/api-catalog/website-to-company-profile.
Using my Seamless.AI API key from SEAMLESS_API_KEY, strip each URL in my list to its root domain,
send them to POST https://api.seamless.ai/api/client/v1/companies/research as {"companies":[{"domain": <domain>}]},
poll GET /companies/research/poll until each status is done, and return companyName, industries,
companySize, companyRevenue, phones, and location.
```

## 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 Research theme={null}
curl -X POST https://api.seamless.ai/api/client/v1/companies/research \
  -H "Token: $SEAMLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"companies": [{"domain": "seamless.ai"}, {"domain": "acme.com"}]}'
```

```bash Poll theme={null}
curl "https://api.seamless.ai/api/client/v1/companies/research/poll?requestIds=REQUEST_ID" \
  -H "Token: $SEAMLESS_API_KEY"
```

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

## Reference

Each item in `companies` needs `domain` or `companyName`. Add `companyName` alongside `domain` to disambiguate.

| Parameter | Type | Required | Description |
| - | - | - | - |
| `companies` | object\[] | Yes | Companies to enrich directly without running search first. Each item must include at least one identifier: `domain`; `companyName`. When only `domain` is supplied, the company name is resolved from Seamless data; if no company is known for that domain the request finishes with status `error` when polled. Up to 500 values. |
| `companies[].domain` | string | No | Company website domain used to identify the company. |
| `companies[].companyName` | string | No | Company legal or common name used to identify the company. |
| `skipDeduplicationCheck` | boolean | No | When true, research will not check for duplicate records that you already researched recently, and perform a research (which can result in credit usage). Default `false`. |

## Response

When a poll returns `status: done`, `company` holds the record:

| Field | Description |
| - | - |
| `companyName`, `description`, `domain` | Identity |
| `industries`, `sicCode`, `naicsCode` | Industry classification |
| `staffCount`, `companySize`, `annualRevenue`, `companyRevenue` | Size and revenue |
| `phones`, `phoneTypes`, `phonesAiScores` | Company phones with confidence (comma-separated, aligned by position) |
| `location` | Headquarters address |
| `topTechnologies` | Detected technologies (comma-separated) |
| `fundingTotal`, `latestFundingDate`, `newsAndEvents` | Growth signals |

If Seamless has no company for a domain, that request's poll status is `error`.

## Errors

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

## Related

* [Company Name → Website](https://docs.seamless.ai/api-catalog/company-name-to-website.md)
* [Company Research API](https://docs.seamless.ai/api-catalog/company-enrichment.md)
* [Data dictionary](https://docs.seamless.ai/api-catalog/data-dictionary.md)


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