Search for people on Apollo.io with powerful filtering capabilities including job titles, seniority, location, company, and more.

Overview

The People Search endpoint allows you to find professionals on Apollo.io using a variety of filter criteria. It returns detailed profile information including contact details, job history, company information, and more.

Method: POST URL: https://app.apollo.io/api/v1/mixed_people/search

Inputs

Core Parameters

| Field | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | page | number | Yes | 1 | Page number for pagination | | qkeywords | string | No | "" | Search keywords (usually person's first and last name) | | apollourl | string | No | "" | Full Apollo URL with filters. When provided, overrides all other filter parameters. |

Job Titles Filter

| Field | Type | Description | |-------|------|-------------| | persontitles | stringList | Job titles to include (e.g., "software engineer", "manager", "director") | | personnottitles | string | Job titles to exclude (e.g., "intern", "student", "assistant") | | personpasttitles | stringList | Past job titles to include | | personnotpasttitles | stringList | Past job titles to exclude | | includesimilartitles | boolean | Whether to include people with similar job titles | | personseniorities | multiselect | Seniority levels (e.g., "owner", "csuite", "vp") | | persondepartmentor_subdepartments | multiselect | Departments or subdepartments |

Location Filter

| Field | Type | Description | |-------|------|-------------| | person_locations | stringList | Locations to search (e.g., "United States", "California") |

Company Filter

| Field | Type | Description | |-------|------|-------------| | organizationids | stringList | Filter by specific company IDs | | organizationdomains | stringList | Filter by company domains | | organizationindustrytag_ids | stringList | Filter by industry tags |

Contact & Email Filter

| Field | Type | Default | Description | |-------|------|---------|-------------| | contactemailstatus_v2 | multiselect | "verified" | Email verification status |

Response

The response contains a list of people matching the search criteria, with detailed profile and company information.

Response Structure

{
  "people": [
    {
      "id": "59fe56a7a6da9861955e1ec1",
      "name": "Mike Braham",
      "first_name": "Mike",
      "last_name": "Braham",
      "title": "Chief Growth Officer and Board of Directors",
      "headline": "AI Whole Health Innovator, Professional Speaker, Board, and C-Suite leader, and advisor",
      "email": "email_not_unlocked@domain.com",
      "email_status": "verified",
      "linkedin_url": "http://www.linkedin.com/in/mikebraham",
      "city": "Spotsylvania Courthouse",
      "state": "Virginia",
      "country": "United States",
      "time_zone": "America/New_York",
      "organization": {
        "id": "66d9abb17ad31f01b4851ca5",
        "name": "Intempo Health",
        "domain": "intempohealth.com",
        "website_url": "http://www.intempohealth.com",
        "estimated_num_employees": 2,
        "industries": ["information technology & services"],
        "founded_year": 2024
      },
      "organization_id": "66d9abb17ad31f01b4851ca5",
      "contact_roles": [],
      "phone_numbers": [],
      "intent_strength": "none",
      "revealed_for_current_team": true
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total_entries": 1000,
    "total_pages": 40
  }
}

Person Object Fields

| Field | Type | Description | |-------|------|-------------| | id | string | Unique person ID | | name | string | Full name | | firstname | string | First name | | lastname | string | Last name | | title | string | Current job title | | headline | string | LinkedIn headline/description | | email | string | Email address (may show placeholder if not unlocked) | | emailstatus | string | Email verification status (e.g., "verified") | | linkedinurl | string | LinkedIn profile URL | | city | string | City | | state | string | State/Province | | country | string | Country | | timezone | string | Time zone (e.g., "America/NewYork") | | organizationid | string | ID of current company | | intentstrength | string | Intent signal strength | | revealedforcurrent_team | boolean | Whether contact info is unlocked |

Organization Object Fields

| Field | Type | Description | |-------|------|-------------| | id | string | Company ID | | name | string | Company name | | domain | string | Primary domain | | websiteurl | string | Company website | | logourl | string | Company logo URL | | estimatednumemployees | number | Estimated employee count | | industries | array | Industry classifications | | foundedyear | number | Year founded | | linkedinurl | string | LinkedIn company page |

Auth & Browser

This endpoint requires authentication. You must be signed in to Apollo.io for the API calls to succeed. The endpoint uses Apollo's session-based authentication.

Examples

Example 1: Search by Job Title

Find software engineers in the United States:

{
  "person_titles": ["software engineer"],
  "person_locations": ["United States"],
  "page": 1
}

Example 2: Search by Name

Find a specific person:

{
  "q_keywords": "Bill Gates",
  "page": 1
}

Example 3: Filter by Seniority

Find C-level executives:

{
  "person_seniorities": ["c_suite", "owner"],
  "person_locations": ["United States"],
  "page": 1
}

Example 4: Search by Company Domain

Find people at specific companies:

{
  "organization_domains": ["microsoft.com", "google.com"],
  "person_titles": ["sales director", "vp sales"],
  "page": 1
}

Notes

Pagination: Use the page parameter to navigate through results. Typical response includes 25 results per page.
Rate Limiting: Be mindful of Apollo's rate limits when making search requests.
Email Unlocking: Contact information (email, phone) may require unlocking through Apollo's credit system. Unlocked contacts show revealedforcurrent_team: true.
Filtering: Combine multiple filters for precise targeting. All filters use AND logic.
Similar Titles: Enable includesimilartitles to expand search to related job titles.
Intent Data: Some results include intent_strength for accounts showing buying signals.