DiscoLike: Find Contacts

Find people with a validated work email at target companies.

Tool ID: discolike_find_contacts

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'discolike_find_contacts',
  {
    "companies": {
      "source": "prompt"
    },
    "max_companies": 123
  },
);

console.log(result.toolResponse.raw);

CLI

deepline run discolike_find_contacts --input '{
  "companies": {
    "source": "prompt"
  },
  "max_companies": 123
}'

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "id": "id_123",
    "kind": "example",
    "status": "example",
    "generation": 123,
    "created_at": "2026-01-15T12:00:00Z",
    "updated_at": "2026-01-15T12:00:00Z",
    "expires_at": "2026-01-15T12:00:00Z"
  }
}

Use deepline describe discolike_find_contacts --json for the latest machine-readable contract.

Input reference

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.

Name	Type	Required	Default	Details
`payload.companies`	`object`	Yes	—	—
`payload.people`	`object`	No	—	—
`payload.relevance`	`"max_relevance" \| "balanced" \| "max_coverage"`	No	—	Allowed: `max_relevance`, `balanced`, `max_coverage`.
`payload.per_company`	`integer`	No	`10`	Maximum validated contacts per company. Minimum: 1. Maximum: 50.
`payload.email_cap_usd`	`number \| string \| null`	No	—	Maximum delivery spend in USD.
`payload.exclude_domains`	`array`	No	—	Maximum items: 100.
`payload.create_key`	`string`	No	—	Idempotency key for starting a run.
`payload.max_companies`	`integer`	Yes	—	Target number of companies that deliver at least one validated contact (1-10,000). Required in Deepline. The run may finish below it. Minimum: 1. Maximum: 10000.
`payload.poll_interval_ms`	`integer`	No	`5000`	Polling interval used while waiting for the contacts run to finish. Defaults to 5000 ms. Minimum: 2000. Maximum: 30000.
`payload.max_wait_ms`	`integer`	No	`120000`	Maximum time to wait for the run to finish. Defaults to 120000 ms. A run still working when the wait ends keeps running and billing. read it later with discolike_get_contacts_run using the returned id. Minimum: 1000. Maximum: 300000.

This input schema is too large for an inline display. Read the complete live contract with deepline describe discolike_find_contacts --json.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.progress`	`record`	No	—	—
`result.data.applied_company_filters`	`object \| null`	No	—	Effective company filters after prompt extraction. absent until resolved.
`result.data.applied_company_filters.filter_industry`	`array \| null`	No	—	Filter by industry category (ANY-OF. prefix + to require a category). Valid values: ACCOUNTING, ADVERTISING_AND_MARKETING, AGRICULTURE_AND_NATURAL_RESOURCES, ALCOHOL_AND_TOBACCO, AUTOMOTIVE, BIG_DATA_AND_ANALYTICS, BIOTECHNOLOGY, BLOCKCHAIN_AND_CRYPTOCURRENCY, BUSINESS_PRODUCTS_AND_SERVICES, CLOUD_COMPUTING, COMPUTER_HARDWARE_AND_SEMICONDUCTORS, CONGLOMERATES_SHELL_AND_HOLDING_COMPANIES, CONSTRUCTION, CONSUMER_PRODUCTS, CONSUMER_SERVICES, CYBERSECURITY, DEFENSE_AND_AEROSPACE, E-COMMERCE, See the live schema for the complete constraint.
`result.data.applied_company_filters.negate_filter_industry`	`array \| null`	No	—	Exclude contacts at companies in specified industries. Valid values: ACCOUNTING, ADVERTISING_AND_MARKETING, AGRICULTURE_AND_NATURAL_RESOURCES, ALCOHOL_AND_TOBACCO, AUTOMOTIVE, BIG_DATA_AND_ANALYTICS, BIOTECHNOLOGY, BLOCKCHAIN_AND_CRYPTOCURRENCY, BUSINESS_PRODUCTS_AND_SERVICES, CLOUD_COMPUTING, COMPUTER_HARDWARE_AND_SEMICONDUCTORS, CONGLOMERATES_SHELL_AND_HOLDING_COMPANIES, CONSTRUCTION, CONSUMER_PRODUCTS, CONSUMER_SERVICES, CYBERSECURITY, DEFENSE_AND_AEROSPACE, E-COMMERCE, EDUCATION, ENERGY, See the live schema for the complete constraint.
`result.data.applied_company_filters.filter_country`	`array \| null`	No	—	Filter by company country using ISO-3166-1 alpha-2 codes (e.g., US, GB, DE). Also accepts region aliases: EU, LATAM, MENA, APAC, NORDICS, DACH, BENELUX, GCC, ASEAN, CEE, ANZ, EUROPE, ASIA, AFRICA, NORTH_AMERICA, SOUTH_AMERICA, OCEANIA, ANTARCTICA.
`result.data.applied_company_filters.negate_filter_country`	`array \| null`	No	—	Exclude contacts at companies in specified countries. Accepts same codes and region aliases as filter_country.
`result.data.applied_company_filters.filter_state`	`array \| null`	No	—	Filter by company state/region. Accepts ISO 3166-2 codes or names, listed at https://docs.discolike.com/states/, resolved against the selected countries. A value that resolves under none is ignored.
`result.data.applied_company_filters.negate_filter_state`	`array \| null`	No	—	Exclude contacts at companies in specified states. Same format as filter_state.
`result.data.applied_company_filters.employee_range`	`string \| null`	No	—	Filter by employee count range. Format: ‘min,max’ (e.g., ‘51,200’). Maps to buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.
`result.data.applied_company_filters.revenue_range`	`string \| null`	No	—	Company revenue range as ‘min,max’ in raw numbers, e.g. ‘10000000,50000000’.
`result.data.applied_company_filters.sub_industry`	`array \| null`	No	—	Only include companies in these sub-industries.
`result.data.error`	`string \| null`	No	—	—
`result.data.input`	`record`	No	—	—
`result.data.id`	`string`	Yes	—	—
`result.data.kind`	`string`	Yes	—	—
`result.data.status`	`string`	Yes	—	—
`result.data.current_step`	`"find_contacts" \| "find_missing" \| "find_emails" \| "discover" \| "validate"`	No	—	Allowed: `find_contacts`, `find_missing`, `find_emails`, `discover`, `validate`.
`result.data.generation`	`integer`	Yes	—	—
`result.data.steps`	`record`	No	—	—
`result.data.total_estimate_usd`	`string \| null`	No	—	—
`result.data.total_charged_usd`	`string`	No	`"0"`	—
`result.data.created_at`	`string`	Yes	—	Format: `date-time`.
`result.data.updated_at`	`string`	Yes	—	Format: `date-time`.
`result.data.expires_at`	`string`	Yes	—	Format: `date-time`.
`result.data.companies`	`array`	No	—	—
`result.data.companies[].company`	`record`	No	—	—
`result.data.companies[].domain`	`string`	Yes	—	—
`result.data.companies[].status`	`"pending" \| "finding_people" \| "finding_emails" \| "validated" \| "skipped" \| "cancelled" \| "failed"`	Yes	—	Allowed: `pending`, `finding_people`, `finding_emails`, `validated`, `skipped`, `cancelled`, `failed`.
`result.data.companies[].people_reviewed`	`integer`	No	`0`	—
`result.data.companies[].mailboxes_checked`	`integer`	No	`0`	—
`result.data.companies[].validated_contacts`	`integer`	No	`0`	—
`result.data.companies[].contacts`	`array`	No	—	—
`result.data.companies[].contacts[].row_key`	`string`	Yes	—	—
`result.data.companies[].contacts[].persona_id`	`integer \| null`	No	—	—
`result.data.companies[].contacts[].domain`	`string`	Yes	—	—
`result.data.companies[].contacts[].name`	`string \| null`	No	—	—
`result.data.companies[].contacts[].title`	`string \| null`	No	—	—
`result.data.companies[].contacts[].linkedin_url`	`string \| null`	No	—	—
`result.data.companies[].contacts[].seniority`	`string \| null`	No	—	—
`result.data.companies[].contacts[].department`	`string \| null`	No	—	—
`result.data.companies[].contacts[].debug_only`	`boolean \| null`	No	—	—
`result.data.companies[].contacts[].reason`	`string \| null`	No	—	—
`result.data.companies[].contacts[].company_score`	`number \| null`	No	—	—
`result.data.companies[].contacts[].p_fit`	`number \| null`	No	—	—
`result.data.companies[].contacts[].fit_label`	`string \| null`	No	—	—
`result.data.companies[].contacts[].floor`	`boolean`	No	`false`	—
`result.data.companies[].contacts[].not_fit`	`boolean`	No	`false`	—
`result.data.companies[].contacts[].email`	`string \| null`	No	—	—
`result.data.companies[].contacts[].email_status`	`string \| null`	No	—	—

The table shows the first 50 fields. Use the live contract below for every field.

This output schema is too large for an inline display. Read the complete live contract with deepline describe discolike_find_contacts --json.

Deepline cost

Pricing model: provider_usage (provider usage).
Estimated Deepline credits: 0 per pricing unit.

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation