Logo

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.


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:

{
  "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:

{
  "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:

{
  "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., @, or similar)

Returns:

  • Uses complex schema for enriched organization data with company details

Example Usage:

{
  "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