> ## Documentation Index
> Fetch the complete documentation index at: https://lava.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Apollo.io

> Sales intelligence platform providing person enrichment, company lookup, people search, org charts, and job posting data for B2B prospecting.

Sales intelligence platform providing person enrichment, company lookup, people search, org charts, and job posting data for B2B prospecting. Best for sales automation workflows — finding decision makers, enriching lead lists, and identifying hiring signals. Unlike People Data Labs (raw data enrichment), Apollo is oriented toward sales prospecting with contact discovery and intent signals.

9 endpoints available through Lava's AI Gateway. See the [Apollo.io API docs](https://docs.apollo.io/reference) for full documentation.

<Info>Supports both **managed** (Lava's API keys) and **unmanaged** (bring your own credentials) mode.</Info>

## Endpoints

### Enrich a person by name, email, LinkedIn, or domain

**POST** `https://api.apollo.io/api/v1/people/match` — \$0.025 / request

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.apollo.io/api/v1/people/match', {
      body: {
    "first_name": "Tim",
    "last_name": "Cook",
    "organization_name": "Apple",
    "domain": "apple.com",
    "email": "tim@apple.com",
    "linkedin_url": "https://linkedin.com/in/timcook",
    "reveal_personal_emails": false,
    "reveal_phone_number": false
    },
    });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Fpeople%2Fmatch" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY" \
      -H "Content-Type: application/json" \
      -d '{"first_name":"Tim","last_name":"Cook","organization_name":"Apple","domain":"apple.com","email":"tim@apple.com","linkedin_url":"https://linkedin.com/in/timcook","reveal_personal_emails":false,"reveal_phone_number":false}'
    ```
  </Tab>
</Tabs>

### Bulk enrich people (up to 10 per request)

**POST** `https://api.apollo.io/api/v1/people/bulk_match` — \$0.025 / request

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.apollo.io/api/v1/people/bulk_match', {
      body: {
    "details": [
      {
        "first_name": "Tim",
        "last_name": "Cook",
        "organization_name": "Apple"
      }
    ]
    },
    });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Fpeople%2Fbulk_match" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY" \
      -H "Content-Type: application/json" \
      -d '{"details":[{"first_name":"Tim","last_name":"Cook","organization_name":"Apple"}]}'
    ```
  </Tab>
</Tabs>

### Enrich an organization by domain

**POST** `https://api.apollo.io/api/v1/organizations/enrich` — \$0.025 / request

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.apollo.io/api/v1/organizations/enrich', { body: {"domain":"apple.com"} });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Forganizations%2Fenrich" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY" \
      -H "Content-Type: application/json" \
      -d '{"domain":"apple.com"}'
    ```
  </Tab>
</Tabs>

### Bulk enrich organizations by domain

**POST** `https://api.apollo.io/api/v1/organizations/bulk_enrich` — \$0.025 / request

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.apollo.io/api/v1/organizations/bulk_enrich', { body: {"domains":["apple.com"]} });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Forganizations%2Fbulk_enrich" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY" \
      -H "Content-Type: application/json" \
      -d '{"domains":["apple.com"]}'
    ```
  </Tab>
</Tabs>

### Search people by title, location, company size

**POST** `https://api.apollo.io/api/v1/mixed_people/api_search` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.apollo.io/api/v1/mixed_people/api_search', {
      body: {
    "person_titles": [
      "ceo"
    ],
    "person_locations": [
      "united states"
    ],
    "organization_industry_tag_ids": [],
    "organization_num_employees_ranges": [
      "1,100"
    ],
    "per_page": 10,
    "page": 1
    },
    });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Fmixed_people%2Fapi_search" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY" \
      -H "Content-Type: application/json" \
      -d '{"person_titles":["ceo"],"person_locations":["united states"],"organization_industry_tag_ids":[],"organization_num_employees_ranges":["1,100"],"per_page":10,"page":1}'
    ```
  </Tab>
</Tabs>

### Search companies by location, size, industry

**POST** `https://api.apollo.io/api/v1/mixed_companies/search` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.apollo.io/api/v1/mixed_companies/search', {
      body: {
    "organization_locations": [
      "united states"
    ],
    "organization_num_employees_ranges": [
      "1,100",
      "101,500"
    ],
    "organization_industry_tag_ids": [],
    "q_organization_keyword_tags": [],
    "per_page": 10,
    "page": 1
    },
    });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Fmixed_companies%2Fsearch" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY" \
      -H "Content-Type: application/json" \
      -d '{"organization_locations":["united states"],"organization_num_employees_ranges":["1,100","101,500"],"organization_industry_tag_ids":[],"q_organization_keyword_tags":[],"per_page":10,"page":1}'
    ```
  </Tab>
</Tabs>

### Search organizations by industry and size

**POST** `https://api.apollo.io/api/v1/organizations/search` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.apollo.io/api/v1/organizations/search', {
      body: {
    "organization_industry_tag_ids": [],
    "organization_num_employees_ranges": [
      "1,100"
    ],
    "per_page": 10,
    "page": 1
    },
    });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Forganizations%2Fsearch" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY" \
      -H "Content-Type: application/json" \
      -d '{"organization_industry_tag_ids":[],"organization_num_employees_ranges":["1,100"],"per_page":10,"page":1}'
    ```
  </Tab>
</Tabs>

### Get organization details by Apollo ID (24-hex, obtained from organizations/enrich or search responses)

**GET** `https://api.apollo.io/api/v1/organizations/5fcd2cf3ed78c700f9383e4e` — \$0.025 / request

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.apollo.io/api/v1/organizations/5fcd2cf3ed78c700f9383e4e', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Forganizations%2F5fcd2cf3ed78c700f9383e4e" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Get job postings for an organization by Apollo ID (24-hex, obtained from organizations/enrich or search responses)

**GET** `https://api.apollo.io/api/v1/organizations/5fcd2cf3ed78c700f9383e4e/job_postings` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.apollo.io/api/v1/organizations/5fcd2cf3ed78c700f9383e4e/job_postings', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Forganizations%2F5fcd2cf3ed78c700f9383e4e%2Fjob_postings" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="All Providers" icon="grid" href="/gateway/supported-providers">
    Browse all supported AI providers
  </Card>

  <Card title="Forward Proxy" icon="route" href="/gateway/forward-proxy">
    Learn how to construct proxy URLs and authenticate requests
  </Card>
</CardGroup>