# Hunter

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Email finding, verification, and company enrichment for outreach and lead generation.

**Category:** Data Enrichment | **Website:** [hunter.io](https://hunter.io) | **Docs:** [hunter.io/api-documentation/v2](https://hunter.io/api-documentation/v2)

## Access Methods

| Method | Base URL | Auth |
|--------|----------|------|
| **MPP (Tempo)** | `https://hunter.mpp.paywithlocus.com/hunter/` | HTTP 402 auto-payment |
| **Locus Pro Wrapped API** | `https://api.paywithlocus.com/api/wrapped/credits/hunter/` | `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` + `Idempotency-Key` |

**OpenAPI discovery:** `GET https://hunter.mpp.paywithlocus.com/openapi.json`

## Endpoints

### Domain Search

Find email addresses associated with a domain. Returns emails, patterns, and organization info.

**Estimated cost:** $0.013-$0.103

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | No | Domain to search (e.g. "stripe.com") |
| `company` | string | No | Company name to search |
| `limit` | number | No | Max emails to return (default 10) |
| `offset` | number | No | Offset for pagination |
| `type` | string | No | Email type filter: 'personal' or 'generic' |
| `seniority` | string | No | Seniority filter: 'junior', 'senior', or 'executive' |
| `department` | string | No | Department filter: 'executive', 'it', 'finance', 'management', 'sales', 'legal', 'support', 'hr', 'marketing', 'communication', 'education', 'design', 'health', 'operations' |
| `required_field` | string | No | Require field: 'full_name', 'position', 'phone_number' |
| `verification_status` | string | No | Filter by status: 'accept_all', 'webmail', 'valid', 'invalid', 'unknown' |

```bash
curl -X POST https://hunter.mpp.paywithlocus.com/hunter/domain-search \
  -H "Content-Type: application/json" \
  -d '{"domain":"stripe.com","limit":1}'
```

### Discover Companies

Search for companies matching specific criteria like industry, size, location, and technology stack.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Free-text search query |
| `organization` | string | No | Organization name to search |
| `similar_to` | string | No | Find companies similar to this domain |
| `headquarters_location` | string | No | Filter by headquarters location |
| `industry` | string | No | Filter by industry |
| `headcount` | string | No | Filter by employee count range (e.g. '1-10', '11-50') |
| `company_type` | string | No | Filter by type: 'public', 'private', 'nonprofit' |
| `keywords` | string | No | Filter by keywords |
| `technology` | string | No | Filter by technology used |
| `limit` | number | No | Max results (default 10) |
| `offset` | number | No | Offset for pagination |

```bash
curl -X POST https://hunter.mpp.paywithlocus.com/hunter/discover \
  -H "Content-Type: application/json" \
  -d '{"query":"payment infrastructure companies","headquarters_location":"San Francisco","limit":1}'
```

### Email Finder

Find the most likely email address for a person given their name and company domain.

**Estimated cost:** $0.013

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | No | Company domain (e.g. "stripe.com") |
| `company` | string | No | Company name |
| `first_name` | string | No | Person's first name |
| `last_name` | string | No | Person's last name |
| `full_name` | string | No | Person's full name (alternative to first+last) |
| `linkedin_handle` | string | No | LinkedIn handle (alternative to domain+name) |
| `max_duration` | number | No | Max processing time in seconds (3-20, default 3) |

```bash
curl -X POST https://hunter.mpp.paywithlocus.com/hunter/email-finder \
  -H "Content-Type: application/json" \
  -d '{"domain":"apple.com","full_name":"Tim Cook","max_duration":10}'
```

### Email Verifier

Verify deliverability of an email address. Checks MX records, SMTP, and returns a confidence score.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `email` | string | Yes | Email address to verify |

```bash
curl -X POST https://hunter.mpp.paywithlocus.com/hunter/email-verifier \
  -H "Content-Type: application/json" \
  -d '{"email":"tcook@apple.com"}'
```

### Email Enrichment

Get person data from an email: name, job title, company, social profiles, and location.

**Estimated cost:** $0.013

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `email` | string | No | Email address to enrich |
| `linkedin_handle` | string | No | LinkedIn handle to enrich |

```bash
curl -X POST https://hunter.mpp.paywithlocus.com/hunter/email-enrichment \
  -H "Content-Type: application/json" \
  -d '{"linkedin_handle":"timothy-cook-488a04396"}'
```

### Company Enrichment

Get company data from a domain: industry, description, employee count, location, tech stack, and social profiles.

**Estimated cost:** $0.013

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | Yes | Company domain (e.g. "stripe.com") |

```bash
curl -X POST https://hunter.mpp.paywithlocus.com/hunter/company-enrichment \
  -H "Content-Type: application/json" \
  -d '{"domain":"stripe.com"}'
```

### Combined Enrichment

Get both person and company data from an email in a single request.

**Estimated cost:** $0.023

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `email` | string | Yes | Email address to enrich |

```bash
curl -X POST https://hunter.mpp.paywithlocus.com/hunter/combined-enrichment \
  -H "Content-Type: application/json" \
  -d '{"email":"tcook@apple.com"}'
```

### Email Count

Get the number of email addresses found for a domain, broken down by type, department, and seniority.

**Estimated cost:** $0.003

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | No | Domain to check (e.g. "stripe.com") |
| `company` | string | No | Company name to check |
| `type` | string | No | Filter by type: 'personal' or 'generic' |

```bash
curl -X POST https://hunter.mpp.paywithlocus.com/hunter/email-count \
  -H "Content-Type: application/json" \
  -d '{"domain":"stripe.com"}'
```