Company Research API

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.

Endpoint

POST /companies/research

Credits

1 credit per record submitted. Details

Delivery

Async. Poll or webhook.

Inputs

Send up to 500 companies per request.

Input	Use when
`searchResultIds`	You found the company with the Company Search API.
`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 lists every field.

Example

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:

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

Response (trimmed)

{
  "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"
      }
    }
  ]
}

If you send only a domain and Seamless has no company for it, the poll returns status: error for that request.

Contact Search API: find people at the companies you enriched
Receive results with webhooks
API reference: Research companies

Catalog

Identity resolution

Search

Contact Search filters

Company Search filters

Research

My data

Platform

Coming soon

Company Research API

Endpoint

Credits

Delivery

Inputs

What you get back

Example

Endpoint

Credits

Delivery

​Inputs

​What you get back

​Example

​Related

Inputs

What you get back

Example

Related