Guides

Building a Prospecting List

Step-by-step guide to building a targeted prospect list using the API.

Step 1: Define your ICP with filters

bash

# Mid-market healthcare companies in CA/NY that recently changed carriers
curl -H "Authorization: Bearer ss_live_..." \
  "https://api.hillwinds.ai/v1/companies?states=CA,NY&industries=Hospitals&employee_bands=Mid-market+Accounts,Enterprise+Accounts&signals=carrier_change&count_only=true"

Check the count first (free) to see if your filters are too broad or narrow.

Step 2: Pull the company list

bash

curl -H "Authorization: Bearer ss_live_..." \
  "https://api.hillwinds.ai/v1/companies?states=CA,NY&industries=Hospitals&employee_bands=Mid-market+Accounts&signals=carrier_change&mode=full&page_size=100"

Step 3: Find decision-makers

For each company, pull VP+ contacts with email:

bash

curl -H "Authorization: Bearer ss_live_..." \
  "https://api.hillwinds.ai/v1/personnel?lead_type=company&company_eins=84629153&seniority=C-suite,VP-Director&has_email=true"

Or find contacts across all your target companies at once:

bash

curl -H "Authorization: Bearer ss_live_..." \
  "https://api.hillwinds.ai/v1/personnel?lead_type=company&states=CA,NY&industries=Hospitals&seniority=C-suite,VP-Director&has_email=true&page_size=100"

Step 4: Export to CSV

bash

# Companies
curl -H "Authorization: Bearer ss_live_..." \
  -o prospects.csv \
  "https://api.hillwinds.ai/v1/companies/export.csv?states=CA,NY&industries=Hospitals&signals=carrier_change&mode=full"

# Contacts
curl -H "Authorization: Bearer ss_live_..." \
  -o contacts.csv \
  "https://api.hillwinds.ai/v1/personnel/export.csv?lead_type=company&states=CA,NY&industries=Hospitals&seniority=C-suite,VP-Director&has_email=true"

Step 5: Tag for tracking

bash

curl -X POST -H "Authorization: Bearer ss_live_..." \
  -H "Content-Type: application/json" \
  -d '{"resource": "companies", "entity_ids": ["84629153", "71038294"], "tag": "q2-2026-outreach"}' \
  "https://api.hillwinds.ai/v1/tags/bulk"

Later, filter by tag: GET /v1/companies?tags=q2-2026-outreach

PreviousCRM Enrichment Next Form 5500 Data

Need a key?

Keys are issued by our team, not a signup form. Book a 25-minute walkthrough and you'll leave with sandbox and live credentials.

Get access Explore the platform