# Apollo

> Lead generation and sales intelligence platform for finding and contacting prospects through organization and people search.

Source: https://cotera.co/docs/reference/tools/individual-tools/apollo

---

**Authentication Type:** API Key\
**Description:** Lead generation and sales intelligence platform for finding and contacting prospects through organization and people search with enrichment capabilities.

***

## Authentication

To authenticate, you'll need an Apollo API key. Learn how to create one in the [Apollo API documentation](https://docs.apollo.io/docs/create-api-key).

***

## Search

Search for organizations and people in the Apollo database with advanced filtering options.

### Search Organizations

Find companies in the Apollo database using filters like industry, employee count, location, revenue, funding stage, and keywords. Results include company details, contact information, and social media links.

**Operation Type:** Mutation (Write)

**Parameters:**

* **organizationNames** `array of strings` (required): Array of organization names to search for (empty array for no filter)
* **websiteUrls** `array of strings` (required): Array of website URLs to search for (empty array for no filter)
* **industryTagIds** `array of strings` (required): Array of industry tag IDs to filter by (empty array for no filter)
* **locations** `array of strings` (required): Array of location names to filter by (empty array for no filter)
* **employeeCountMin** `number` (nullable): Minimum number of employees
* **employeeCountMax** `number` (nullable): Maximum number of employees
* **fundingStageIds** `array of strings` (required): Array of funding stage IDs to filter by (empty array for no filter)
* **revenueRangeIds** `array of strings` (required): Array of revenue range IDs to filter by (empty array for no filter)
* **keywords** `array of strings` (required): Array of keywords to search for (empty array for no filter)
* **foundedYearMin** `number` (nullable): Minimum founding year
* **foundedYearMax** `number` (nullable): Maximum founding year
* **publiclyTraded** `boolean` (nullable): Filter for publicly traded companies
* **page** `number` (required): Page number (starting from 1)
* **perPage** `number` (required): Number of records per page (max 100)

**Returns:**

* **organizations** `array of objects`: Array of matching organizations
  * **id** `string`: Apollo organization ID
  * **name** `string`: Company name
  * **website\_url** `string` (nullable): Company website URL
  * **linkedin\_url** `string` (nullable): LinkedIn company page URL
  * **primary\_phone** `object` (nullable): Primary phone number with source
  * **industry** `string` (nullable): Company industry
  * **estimated\_num\_employees** `number` (nullable): Estimated number of employees
  * **founded\_year** `number` (nullable): Year the company was founded
  * **city** `string` (nullable): City location
  * **state** `string` (nullable): State or province
  * **country** `string` (nullable): Country
* **pagination** `object`: Pagination information
  * **page** `number`: Current page number
  * **per\_page** `number`: Records per page
  * **total\_entries** `number`: Total number of results
  * **total\_pages** `number`: Total number of pages

**Example Usage:**

```json
{
  "organizationNames": ["Acme Corp"],
  "websiteUrls": [],
  "industryTagIds": ["tech_001"],
  "locations": ["San Francisco, CA"],
  "employeeCountMin": 50,
  "employeeCountMax": 500,
  "fundingStageIds": [],
  "revenueRangeIds": [],
  "keywords": ["SaaS", "software"],
  "foundedYearMin": 2010,
  "foundedYearMax": null,
  "publiclyTraded": false,
  "page": 1,
  "perPage": 25
}
```

### Search People

Find people in the Apollo database using filters like job title, company, location, seniority level, department, and email status. Results include professional information, contact details, and employment history.

**Operation Type:** Mutation (Write)

**Parameters:**

* **personTitles** `array of strings` (required): Array of job titles to search for (empty array for no filter)
* **organizationIds** `array of strings` (required): Array of organization IDs to filter by (empty array for no filter)
* **organizationNames** `array of strings` (required): Array of organization names to filter by (empty array for no filter)
* **personNames** `array of strings` (required): Array of person names to search for (empty array for no filter)
* **personLocations** `array of strings` (required): Array of person locations to filter by (empty array for no filter)
* **personSeniorities** `array of strings` (required): Array of seniority levels to filter by (empty array for no filter)
* **contactEmailStatus** `array of strings` (required): Array of email statuses to filter by (verified, likely, etc.) (empty array for no filter)
* **departmentIds** `array of strings` (required): Array of department IDs to filter by (empty array for no filter)
* **industryTagIds** `array of strings` (required): Array of industry tag IDs to filter by (empty array for no filter)
* **organizationNumEmployeesRanges** `array of strings` (required): Array of employee count ranges (empty array for no filter)
* **keywords** `array of strings` (required): Array of keywords to search for (empty array for no filter)
* **currentCompany** `boolean` (nullable): Filter for current company only
* **page** `number` (required): Page number (starting from 1)
* **perPage** `number` (required): Number of records per page (max 100)

**Returns:**

* **people** `array of objects`: Array of matching people
  * **id** `string`: Apollo person ID
  * **first\_name** `string` (nullable): First name
  * **last\_name** `string` (nullable): Last name
  * **name** `string` (nullable): Full name
  * **linkedin\_url** `string` (nullable): LinkedIn profile URL
  * **title** `string` (nullable): Job title
  * **email\_status** `string` (nullable): Email status (verified, etc.)
  * **email** `string` (nullable): Email address
  * **organization\_id** `string` (nullable): Associated organization ID
  * **city** `string` (nullable): City location
  * **state** `string` (nullable): State or province
  * **country** `string` (nullable): Country
* **pagination** `object`: Pagination information
  * **page** `number`: Current page number
  * **per\_page** `number`: Records per page
  * **total\_entries** `number`: Total number of results
  * **total\_pages** `number`: Total number of pages

**Example Usage:**

```json
{
  "personTitles": ["Software Engineer", "Developer"],
  "organizationIds": [],
  "organizationNames": ["Google", "Microsoft"],
  "personNames": [],
  "personLocations": ["San Francisco Bay Area"],
  "personSeniorities": ["Senior", "Lead"],
  "contactEmailStatus": ["verified"],
  "departmentIds": ["eng_001"],
  "industryTagIds": ["tech_001"],
  "organizationNumEmployeesRanges": ["1000-5000"],
  "keywords": ["React", "JavaScript"],
  "currentCompany": true,
  "page": 1,
  "perPage": 50
}
```

***

## Enrichment

Keep your records clean and up to date automatically with enrichment data.

### People Enrichment

Enrich a person's profile using their email or LinkedIn URL, returning detailed professional and contact information such as name, job title, company, and social profiles.

**Operation Type:** Mutation (Write)

**Parameters:**

* Uses complex schema for person enrichment parameters (email, LinkedIn URL, etc.)

**Returns:**

* Uses complex schema for enriched person data with professional information

**Example Usage:**

```json
{
  "email": "john.doe@example.com"
}
```

### Organization Enrichment

Provide detailed company information—such as name, industry, size, location, and social profiles—based on a domain or company name input.

**Operation Type:** Mutation (Write)

**Parameters:**

* **domain** `string` (required): The domain of the company to enrich (do not include [www](http://www)., @, or similar)

**Returns:**

* Uses complex schema for enriched organization data with company details

**Example Usage:**

```json
{
  "domain": "example.com"
}
```

***

## Common Use Cases

**Lead Generation:**

* Search for companies matching your ideal customer profile
* Find decision makers at target companies
* Filter by company size, industry, and funding stage

**Contact Discovery:**

* Search for people by job title and seniority
* Find verified email addresses for outreach
* Locate contacts at specific companies

**Data Enrichment:**

* Enrich existing contact records with fresh data
* Validate and update company information
* Get detailed professional profiles for leads

**Market Research:**

* Analyze company landscapes by industry and location
* Identify trends in funding and company growth
* Research competitor employees and structures