> ## 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 Research API

> Turn a domain or company name into firmographics, company phones, headquarters address, funding, technologies, and news.

The Company Research API researches a company and returns its full record: description, industry and SIC/NAICS codes, headcount, revenue, phone numbers with confidence scores, headquarters address, top technologies, funding, and recent news.

> [card] Endpoint
>
> `POST /companies/research`

> [card] Credits
>
> 1 credit per record submitted.
> [Details](https://docs.seamless.ai/core-concepts/credits.md)

> [card] Delivery
>
> Async. [Poll](https://docs.seamless.ai/api-reference/v1/company-research/poll-company-research.md) or [webhook](https://docs.seamless.ai/workflows/receive-research-results-with-webhooks.md).

## Inputs

Send up to 500 companies per request.

| Input | Use when |
| - | - |
| `searchResultIds` | You found the company with the [Company Search API](https://docs.seamless.ai/api-catalog/company-search.md). |
| `companies[].domain` | You have a website domain, for example from a form fill or a CRM account. |
| `companies[].companyName` | You have only a company name. Add `domain` when you have it for a more precise match. |

`skipDeduplicationCheck: true` re-researches companies your org researched recently. This uses credits again.

## What you get back

| Category | Attributes |
| - | - |
| Identity | `companyName`, `domain`, `description`, `linkedInProfileUrl`, `linkedInId`, `foundedOn`, `companyType`, `stockTicker` |
| Firmographics | `industries`, `sicCode`, `naicsCode`, `staffCount`, `companySize`, `annualRevenue`, `companyRevenue` |
| Contact | `phones`, `phoneTypes`, `phonesAiScores` (confidence %), `location` (street, city, state, postal code, country) |
| Technology | `topTechnologies` |
| Signals | `fundingTotal`, `latestFundingDate`, `latestFundingClassifications`, `newsAndEvents[]` |
| Research links | Ready-made URLs for SEC filings, Google Finance, Yahoo Finance, Wikipedia, job postings, employee reviews, SEO and paid search research, web technologies, WHOIS |

`industries`, `phones`, `phoneTypes`, `phonesAiScores`, and `topTechnologies` are comma-separated strings. The values in `phones`, `phoneTypes`, and `phonesAiScores` line up by position. The [Data dictionary](https://docs.seamless.ai/api-catalog/data-dictionary.md) lists every field.

## Example

```bash 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"},
      {"companyName": "Acme Corp", "domain": "acme.com"}
    ]
  }'
```

Poll with the returned `requestIds`:

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

```json Response (trimmed) theme={null}
{
	"success": true,
	"data": [
		{
			"requestId": "...",
			"status": "done",
			"company": {
				"companyName": "Seamless.AI",
				"domain": "seamless.ai",
				"industries": "Computer Software",
				"companySize": "201 - 500",
				"companyRevenue": "$50M - $100M",
				"phones": "+1 ...",
				"phoneTypes": "main",
				"phonesAiScores": "95",
				"topTechnologies": "Salesforce, HubSpot",
				"companyType": "Private"
			}
		}
	]
}
```

> [!NOTE]
>
> If you send only a `domain` and Seamless has no company for it, the poll
> returns `status: error` for that request.

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.

## Related

* [Contact Search API](https://docs.seamless.ai/api-catalog/contact-search.md): find people at the companies you enriched
* [Receive results with webhooks](https://docs.seamless.ai/workflows/receive-research-results-with-webhooks.md)
* [API reference: Research companies](https://docs.seamless.ai/api-reference/v1/company-research/research-companies.md)


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