​

Playbook

​

Dropleads Playbook

​

1) Start with low-cost discovery

• Use dropleads_get_lead_count to size the audience before any paid call.
• Use dropleads_search_people to inspect masked contacts and validate ICP filters (free).
• Use dropleads_search_people after you already have target account domains, by passing filters.companyDomains. It is a contact search primitive, not a dependable way to discover target accounts.
• Do not build joins or account-discovery flows that depend on every returned lead having companyDomain. Treat returned companyDomain as optional; if you need account domains as the source of truth, use a company-native search/enrichment tool first.
• Tighten filters until sample rows clearly match role, industry, and geo expectations.
• Key filter fields: filters.jobTitles, filters.seniority (VP/Director/Manager/Senior/Entry/Intern), filters.industries, filters.departments, filters.companyDomains, filters.employeeRanges, filters.personalCountries, filters.personalStates, filters.personalCities, filters.organizationCountries, filters.organizationStates, filters.organizationCities, pagination.page, pagination.limit. Use personal* for the contact’s location and organization* for company HQ; a person’s location is not necessarily their employer’s HQ. Use title terms like CEO, CTO, or Founder for C-level searches; do not pass C-Level as a Dropleads seniority value — Dropleads’ own API docs list it, but live validation rejects it. filters.seniorityExclude and filters.departmentsExclude take the same exact values as their include twins.

​

Filter best practices

{
  "filters": {
    "companyDomains": ["microsoft.com"],
    "jobTitles": ["CTO", "VP Engineering"],
    "seniority": ["VP", "Director"],
    "personalCountries": { "include": ["United States"] }
  },
  "pagination": { "page": 1, "limit": 25 }
}

​

Exclude filters use the same vocabulary as their include twin

​

Geo filters are best-effort, not verified

• City-level is the loosest match and leaks. personalCities can return contacts whose stated city loosely matches even when their real location differs, and non-US contacts can appear under a US-city filter (e.g. a Bulgarian contact surfacing under personalCities: San Francisco + personalCountries: United States). Country/state are more reliable.
• Person vs. company location are different fields. personal* filters the contact’s own location; organization* filters the company HQ. Don’t conflate them — filtering a remote employee by company HQ city (or vice versa) drops or leaks legitimate matches.
• Verify geo when precision matters. Combine personalCountries/personalStates with personalCities, then post-filter the returned leads on their country/state/city (and exclude obvious mismatches) before trusting the result or spending on enrichment. Do not assume the filter alone guarantees the geo.

​

2) Escalate paid calls only for shortlisted targets

• Run dropleads_email_finder for contacts that passed the discovery pass.
• Run dropleads_mobile_finder only when phone is required for the workflow.
• Keep pilots small first, then scale after quality checks pass.

​

3) Gate outbound with verifier status

• Treat invalid, catch_all, and unknown as non-send by default.
• Treat valid as the only status that passes automatic send gates.
• Respect credits_charged in responses for post-execution billing accuracy.

​

4) Practical sequencing

1. Count segment (dropleads_get_lead_count).
2. Sample segment (dropleads_search_people).
3. Pre-score titles with run_javascript if looking for a specific profile (e.g. founders, GTM engineers).
4. Retrieve LinkedIn profiles with harvestapi_get_profile for structured work history and signals. Use Apify only when native HarvestAPI does not expose the required LinkedIn shape.
5. Extract signals with run_javascript from the structured HarvestAPI output (e.g. founder detection, hiring signals).
6. Enrich emails via waterfall (dropleads_email_finder first, then other providers).
7. Verify candidate emails (dropleads_email_verifier or leadmagic_email_validation).
8. Expand only after pilot quality is confirmed.

​

5) Account discovery boundary