# Hunter

> **You are on:** `https://beta-api.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API |
> |---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com |
> | Beta | beta.paywithlocus.com | beta-api.paywithlocus.com |
> | Stage | stage.paywithlocus.com | stage-api.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 |
| **Wrapped API** | `https://beta-api.paywithlocus.com/api/wrapped/hunter/` | `Authorization: Bearer <LOCUS_API_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":"<string>","company":"<string>","limit":"<number>","offset":"<number>","type":"<string>","seniority":"<string>","department":"<string>","required_field":"<string>","verification_status":"<string>"}'
```

### 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":"<string>","organization":"<string>","similar_to":"<string>","headquarters_location":"<string>","industry":"<string>","headcount":"<string>","company_type":"<string>","keywords":"<string>","technology":"<string>","limit":"<number>","offset":"<number>"}'
```

### 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":"<string>","company":"<string>","first_name":"<string>","last_name":"<string>","full_name":"<string>","linkedin_handle":"<string>","max_duration":"<number>"}'
```

### 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":"<string>"}'
```

### 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 '{"email":"<string>","linkedin_handle":"<string>"}'
```

### 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":"<string>"}'
```

### 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":"<string>"}'
```

### 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":"<string>","company":"<string>","type":"<string>"}'
```