Skip to main content
POST
Find missing company domains
With a crm_company_id, this writes to your real CRM. Each domain delivered spends one credit, and these credits do not refill. It only fills empty fields. LinkedIn is not touched.

What this call does

Good to know

  • A name-only answer of resolved still spends a credit.
  • When credits run out, the answer stays a 200: the item says no_credits and the rest of the batch is listed in not_processed.
  • ambiguous and not_found are normal, spend nothing, and are remembered for up to 30 days. Send a person who works there in your first request.
Your AI assistant reaches the same action through the MCP tool find_company_domains.

Authorizations

Authorization
string
header
required

Your Groovin API key (gv_live_…), created in the extension under Settings, MCP and API.

Body

application/json
companies
object[]
required

The companies, up to 25 per call. Each needs a crm_company_id or a company_name.

Required array length: 1 - 25 elements

Response

Success.

The result of a batch. The batch can stop early: send what is in not_processed again.

total
integer
required

Companies asked for, without duplicates.

processed
integer
required

Companies actually handled.

found
integer
required

Domains found.

updated
integer
required

CRM records changed.

failed
integer
required

Lookups that failed.

not_processed
string[]
required

Companies this call did not start, by id or name.

not_processed_reason
string | null
required

Why the batch stopped early, in plain text.

remaining_credits
integer
required

Your domain credits after this call.

retry_guidance
string | null
required

Plain-text advice when some items failed for a temporary reason, otherwise null. Follow it: it says when to retry, and which items.

results
object[]
required

One item per company.