Skip to main content
You do not always need to call search first. The research endpoints accept direct identifiers so you can enrich records you already know.

​
When to use this path

  • You already have a company domain or company name from your CRM or spreadsheet.
  • You already have a contact name, company, and optional title from another system.
  • You want a shorter integration when search filters are unnecessary.
If you need to discover targets by filters (job title, industry, location), start with Search companies or Search contacts, then pass the returned searchResultId to research. See Understand identifiers and request flow.

​
Research companies directly

POST Research companies with a companies array. Each item needs at least one of domain or companyName.
The response is HTTP 202 Accepted with requestIds. Poll with Poll company research results or use webhooks. You can also combine searchResultIds from a prior search with companies in the same request (up to 500 items total).

​
Optional: skip deduplication

Set skipDeduplicationCheck: true to force a new research run even if Seamless recently researched the same company. This may consume additional credits. Default is false.

​
Research contacts directly

POST Research contacts with a contacts array. Each item needs one of: contactName with companyName or domain, an email, or a LinkedIn URL; add title when you have it.
Poll with Poll contact research results. Terminal poll statuses for contacts include done, error, not found, and duplicate; missing means the requestId is not one the server knows.

​
Job-change research

Set isJobChange: true when researching contacts who recently changed roles. Pass the same contacts shape; see Research contacts in the API reference for examples.

​
Retrieve results

Same as the search-then-research flow:
  • Webhooks — push delivery to your HTTPS endpoint.
  • Polling — call the poll endpoint with each requestId until status is terminal.