contacts-run

Start a contacts run

Changed on

Finds and validates contacts automatically, using database candidates before web fallback. Poll for live companies and validated contacts. max_companies counts companies with a validated delivery. Repeating create_key returns the same run.

post/contacts/run

Request

  • Base URL
    https://api.discolike.com (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Request body

relevance'max_relevance' | 'balanced' | 'max_coverage'
max_companiesinteger

Target companies delivering at least one validated contact.

per_companyinteger

Maximum validated contacts per company.

exclude_query_idsstring[]
exclude_domainsstring[]
create_keystring nullable

Idempotency key for starting a run.

Response

The step was accepted and runs in the background.

progressobject
errorstring nullable
inputobject
idstring required
kindstring required
statusstring required
current_step'find_contacts' | 'find_missing' | 'find_emails' | 'discover' | 'validate'
generationinteger required
stepsobject
total_estimate_usdstring nullable
total_charged_usdstring
created_atstring date-time required
updated_atstring date-time required
expires_atstring date-time required
companies_totalinteger

Company domains available for pagination, including diagnostic rows in dev/local.

contacts_totalinteger

Visible contacts across the run. Contacts runs page by company domain, keeping each company and its contacts together.

Changes