# Apollo

> **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.

> People and company enrichment, lead search, and sales intelligence with 275M+ contacts.

**Category:** Data Enrichment | **Website:** [www.apollo.io](https://www.apollo.io) | **Docs:** [docs.apollo.io](https://docs.apollo.io)

## Access Methods

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

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

## Endpoints

### People Enrichment

Find and enrich a person by name, company, email, or LinkedIn URL, returning contact details such as personal emails and phone numbers when requested.

**Estimated cost:** $0.038-$0.318

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `first_name` | string | No | First name |
| `last_name` | string | No | Last name |
| `email` | string | No | Email address |
| `linkedin_url` | string | No | LinkedIn profile URL |
| `organization_name` | string | No | Current company name |
| `domain` | string | No | Current company domain |
| `id` | string | No | Apollo person ID |
| `reveal_personal_emails` | boolean | No | Include personal emails in results |
| `reveal_phone_number` | boolean | No | Include phone numbers (+$0.280) |

```bash
curl -X POST https://apollo.mpp.paywithlocus.com/apollo/people-enrichment \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Tim","last_name":"Cook","domain":"apple.com"}'
```

### Bulk People Enrichment

Enrich up to 10 people in a single request.

**Estimated cost:** $0.038-$0.318/person

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `details` | object[] | Yes | Array of person identifiers (max 10). Each object can have: first_name, last_name, email, linkedin_url, organization_name, domain |
| `reveal_phone_number` | boolean | No | Include phone numbers for all (+$0.280/person) |
| `reveal_personal_emails` | boolean | No | Include personal emails for all |

```bash
curl -X POST https://apollo.mpp.paywithlocus.com/apollo/bulk-people-enrichment \
  -H "Content-Type: application/json" \
  -d '{"details":[{"first_name":"Tim","last_name":"Cook","domain":"apple.com"}],"reveal_phone_number":false,"reveal_personal_emails":false}'
```

### Organization Enrichment

Get company data including industry, employee count, funding, revenue, and tech stack.

**Estimated cost:** $0.038

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | No | Company domain |
| `linkedin_url` | string | No | Company LinkedIn URL |
| `website` | string | No | Full company website URL |
| `name` | string | No | Company name to improve identifier match accuracy |

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

### Bulk Organization Enrichment

Enrich up to 10 organizations by domain in a single request.

**Estimated cost:** $0.038/org

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domains` | string[] | Yes | Array of company domains (max 10), e.g. ["anthropic.com", "openai.com"] |

```bash
curl -X POST https://apollo.mpp.paywithlocus.com/apollo/bulk-org-enrichment \
  -H "Content-Type: application/json" \
  -d '{"domains":["apple.com"]}'
```

### People Search

Search for people by job title, location, company, seniority, and more. Returns profile data but not contact details (use enrichment for emails/phones).

**Estimated cost:** $0.005

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `q_keywords` | string | No | Keywords to search for |
| `person_titles` | string[] | No | Job titles to filter by |
| `person_locations` | string[] | No | Locations to filter by |
| `q_organization_domains_list` | string[] | No | Company domains to filter by |
| `organization_ids` | string[] | No | Apollo organization IDs to filter by |
| `person_seniorities` | string[] | No | Seniority levels: founder, c_suite, partner, vp, head, director, manager, senior, entry, intern |
| `per_page` | number | No | Results per page (max 100, default 25) |
| `page` | number | No | Page number (max 500) |

```bash
curl -X POST https://apollo.mpp.paywithlocus.com/apollo/people-search \
  -H "Content-Type: application/json" \
  -d '{"q_organization_domains_list":["apple.com"],"per_page":1,"page":1}'
```

### Organization Search

Search for companies by name, industry, location, size, revenue, and more.

**Estimated cost:** $0.038

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `q_organization_domains_list` | string[] | No | Company domains to filter by (max 1,000) |
| `q_organization_name` | string | No | Organization name to search |
| `organization_ids` | string[] | No | Apollo organization IDs to filter by |
| `organization_locations` | string[] | No | Locations to filter by |
| `q_organization_keyword_tags` | string[] | No | Keyword tags to filter by |
| `organization_num_employees_ranges` | string[] | No | Employee count ranges (e.g., "1,10", "11,50", "51,200") |
| `per_page` | number | No | Results per page (max 100, default 25) |
| `page` | number | No | Page number (max 500) |

```bash
curl -X POST https://apollo.mpp.paywithlocus.com/apollo/org-search \
  -H "Content-Type: application/json" \
  -d '{"q_organization_name":"Apple","per_page":1,"page":1}'
```

### Organization Job Postings

Get current job postings for a company — useful for identifying hiring signals.

**Estimated cost:** $0.038

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `organization_id` | string | Yes | Apollo organization ID |
| `page` | number | No | Positive page number |
| `per_page` | number | No | Results per page (max 10,000) |

```bash
curl -X POST https://apollo.mpp.paywithlocus.com/apollo/job-postings \
  -H "Content-Type: application/json" \
  -d '{"organization_id":"<from apollo/org-enrichment>","page":1,"per_page":1}'
```

### News Articles Search

Find recent news articles connected to organizations in Apollo's database. Requires organization IDs (get them from org-search or org-enrichment first).

**Estimated cost:** $0.038

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `organization_ids` | string[] | Yes | Apollo organization IDs to find news for |
| `categories` | string[] | No | News categories such as hires, investment, or contract |
| `published_at_min` | string | No | Earliest publication date (YYYY-MM-DD) |
| `published_at_max` | string | No | Latest publication date (YYYY-MM-DD) |
| `per_page` | number | No | Results per page (max 25) |
| `page` | number | No | Page number |

```bash
curl -X POST https://apollo.mpp.paywithlocus.com/apollo/news-search \
  -H "Content-Type: application/json" \
  -d '{"organization_ids":["<from apollo/org-enrichment>"],"per_page":1,"page":1}'
```