How It Works
Providers are tried left to right. The first one to return a result wins — the rest are skipped. At least 2 results are required before stopping. * Only runs when optional fields are provided.Parameters
| Name | Type | Required | Description | |
|---|---|---|---|---|
company_name | string | No | Company name for human context and provider fallbacks. | |
domain | string | No | Company domain for contact lookup (for example acme.com). | |
linkedin_company_url | string | No | Optional LinkedIn company URL in /company/ format. Use this when you have the LinkedIn company page but not the domain. | |
roles | `array | string` | Yes | Primary persona intent for contact lookup. Accepts one or more role strings as an array or comma-separated string. Prefer exact, real-world title tokens when you know them. |
seniority | `array | string` | No | Broad seniority intent for cross-provider matching. Use portable values like C-Level, Founder, VP, Head, Director, Manager, Senior, Entry, or Intern. |
limit | integer | No | Optional result cap per waterfall step (1-100). Use 1 for the single best candidate, or 3 when you want a few exact-title options to review. |
Cost
0-2.04 credits — waterfalls stop at the first match, so you only pay for the provider that returns a result.| Step | Max Credits |
|---|---|
| Deepline Native: Deepline Native Search Contact By Domain | 0.6 |
| Deepline Native: Deepline Native Search Contact By Linkedin Company | 0.6 |
| Apollo | 0.2 |
| Icypeas | 0.2 |
| Prospeo | 0.6 |
| Crustdata | 0 |