# Apollo People Enrichment API

> Enrich one person: give whatever identifiers you have and get back Apollo's full record for them. Send identifiers in the JSON request body, not the query string.

Source: https://www.sandbase.ai/model/apollo/people-match
API reference: https://www.sandbase.ai/model/apollo/people-match/docs

## Facts

- Provider: Apollo
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/apollo/people-match`
- Price: $0.03 per call
- Capabilities: api, apollo, company data
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/apollo/people-match` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `domain` | string | no |  |
| `email` | string | no |  |
| `first_name` | string | no |  |
| `hashed_email` | string | no |  |
| `id` | string | no |  |
| `last_name` | string | no |  |
| `linkedin_url` | string | no |  |
| `name` | string | no |  |
| `organization_name` | string | no |  |

## FAQ

### How do I use the Apollo People Enrichment API?

Send a POST request to https://api.sandbase.ai/v1/api/apollo/people-match with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Apollo People Enrichment API cost?

$0.03 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Apollo People Enrichment API accept?

No parameters are required. Optional: domain (string), email (string), first_name (string), hashed_email (string), id (string) and last_name (string) and 3 more. The Parameters table and the Playground on this page list every field.

### What does the Apollo People Enrichment API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Apollo developer account or API key?

No. Apollo People Enrichment runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Apollo API access separately.

## README

### Apollo People Enrichment API

Enrich one person: give whatever identifiers you have and get back Apollo's full record for them. Send identifiers in the JSON request body, not the query string.

The response is the official Apollo API response, unchanged.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "apollo/people-match"}'
```

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `domain` | string | No | The domain name for the person's employer. This can be the current employer or a previous employer. Do not include www., the @ symbol, or similar. Example: apol |
| `email` | string | No | The email address of the person. Example: example@email.com |
| `first_name` | string | No | The first name of the person. This is typically used in combination with the last_name parameter. Example: tim |
| `hashed_email` | string | No | The hashed email of the person. The email should adhere to either the MD5 or SHA-256 hash format. Example: 8d935115b9ff4489f2d1f9249503cadf (MD5) or 97817c0c499 |
| `id` | string | No | The Apollo ID for the person. Each person in the Apollo database is assigned a unique ID. To find IDs, call the People API Search endpoint and identify the valu |
| `last_name` | string | No | The last name of the person. This is typically used in combination with the first_name parameter. Example: zheng |
| `linkedin_url` | string | No | The URL for the person's LinkedIn profile. Example: http://www.linkedin.com/in/tim-zheng-677ba010 |
| `name` | string | No | The full name of the person. This will typically be a first name and last name separated by a space. If you use this parameter, you do not need to use the first |
| `organization_name` | string | No | The name of the person's employer. This can be the current employer or a previous employer. Example: apollo |

#### Pricing

Flat price per call. Failed calls are not charged.