Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaLead GenAvailable now

Hunter · Company emails

hunter/companies/emails

Find companies, people and contact details with Hunter · Company emails from Alexandria through one Spiral API key. List email addresses Hunter has for one company domain or company name, with roles and confidence. A row is not a completed verification: check each address with people/email-verify before sending mail. Use people/email-find for one named person. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

Up to $0.17459 per run at the default inputs. $0.017459 per unit of limit.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
typeone of
personal, generic
—

personal for named people, generic for role addresses such as info@.

limitnumber
1 to 100
10

Addresses to return. Hunter's default is 10 and the maximum is 100. 10 Firecrawl credits per started group of 10 returned addresses.

domaintext—

Company domain, such as stripe.com. Preferred over company. No scheme or path.

offsetnumber
0 to …
—

Addresses to skip. Hunter's default is 0.

companytext—

Company name, when the domain is unknown. Domain wins when both are sent.

senioritytext—

junior, senior, or executive. Comma-separate to combine.

departmenttext—

One or more of executive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations, product, research, consulting, administrative, procurement. Comma-separate to combine.

job_titlestext—

Comma-separated job titles. Common abbreviations match their full forms.

provenanceone of
found, inferred
—

found addresses were seen on a public page. inferred addresses were built from the company pattern.

aggregationstrue or false—

Include meta.aggregations: department counts, decision makers, and the personal/generic split.

decision_makertrue or false—

true for people Hunter classifies as decision makers, false for people it classifies as not. Unclassified addresses match neither.

required_fieldtext—

full_name, position, or phone_number. Comma-separate to require several.

verification_statustext—

valid, accept_all, or unknown. Comma-separate to combine. A row with no verification is not valid.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "hunter/companies/emails",
    "input": {
      "domain": "<domain>"
    }
  }'

Frequently asked questions

How much does Hunter · Company emails cost?

Up to $0.17459 per run at the default inputs. $0.017459 per unit of `limit`. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Hunter · Company emails through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "hunter/companies/emails"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use Hunter · Company emails?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use Hunter · Company emails?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.