---
title: "People API Search"
method: POST
path: "/mixed_people/api_search"
tags: ["Search"]
---

# People API Search

`POST /mixed_people/api_search`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

<a href="https://knowledge.apollo.io/hc/en-us/articles/4412658716941-Search-for-People" target="_blank">People</a> are net-new prospects you haven't yet saved as contacts on Apollo.<br><br>Use the People API Search endpoint to find new prospects. Several filters are available to help narrow your search. This endpoint doesn't return email addresses or phone numbers. Use the <a href="https://docs.apollo.io/reference/people-enrichment">People Enrichment</a> or <a href="https://docs.apollo.io/reference/bulk-people-enrichment">Bulk People Enrichment</a> endpoints to enrich data.<br><br>This endpoint requires a master API key. Check out <a href="https://docs.apollo.io/docs/create-api-key" target="_blank">Create an API Key</a> to learn how to create a master key.<br><br>To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible.

## Query parameters

- `person_titles[]` string[]
- `include_similar_titles` boolean
- `q_keywords` string
- `person_locations[]` string[]
- `person_seniorities[]` string[]
- `organization_locations[]` string[]
- `q_organization_domains_list[]` string[]
- `contact_email_status[]` string[]
- `organization_ids[]` string[]
- `organization_num_employees_ranges[]` string[]
- `revenue_range[min]` integer
- `revenue_range[max]` integer
- `currently_using_all_of_technology_uids[]` string[]
- `currently_using_any_of_technology_uids[]` string[]
- `currently_not_using_any_of_technology_uids[]` string[]
- `q_organization_job_titles[]` string[]
- `organization_job_locations[]` string[]
- `organization_num_jobs_range[min]` integer
- `organization_num_jobs_range[max]` integer
- `organization_job_posted_at_range[min]` string, date
- `organization_job_posted_at_range[max]` string, date
- `page` integer
- `per_page` integer

## Response `200`

200

- object
  - `total_entries` integer — The total number of people that match your search criteria.
  - `people` object[] — An array of people that match your search criteria.
    - `id` string — The Apollo ID for the person.
    - `first_name` string — The first name of the person.
    - `last_name_obfuscated` string — The last name of the person with the middle characters obfuscated for privacy. The format shows the first 2 characters, followed by asterisks, and then the last character.
    - `title` string, nullable — The job title of the person. This field may be null if the person's title is not available.
    - `last_refreshed_at` string, date-time — The date and time when the person's data was last refreshed in Apollo's database.
    - `has_email` boolean — Indicates whether Apollo has a verified email address for this person.
    - `has_city` boolean — Indicates whether Apollo has city location data for this person.
    - `has_state` boolean — Indicates whether Apollo has state location data for this person.
    - `has_country` boolean — Indicates whether Apollo has country location data for this person.
    - `has_direct_phone` string — Indicates whether Apollo has direct phone number data for this person. Returns `Yes` if available, or `Maybe: please request direct dial via people/bulk_match` if uncertain.
    - `organization` object — Information about the person's current employer organization.
      - `name` string — The name of the organization.
      - `has_industry` boolean — Indicates whether Apollo has industry classification data for this organization.
      - `has_phone` boolean — Indicates whether Apollo has phone number data for this organization.
      - `has_city` boolean — Indicates whether Apollo has city location data for the organization's headquarters.
      - `has_state` boolean — Indicates whether Apollo has state location data for the organization's headquarters.
      - `has_country` boolean — Indicates whether Apollo has country location data for the organization's headquarters.
      - `has_zip_code` boolean — Indicates whether Apollo has postal/zip code data for the organization's headquarters.
      - `has_revenue` boolean — Indicates whether Apollo has revenue data for this organization.
      - `has_employee_count` boolean — Indicates whether Apollo has employee count data for this organization.

## Other responses

- `401` — 401
- `403` — 403
- `422` — 422
- `429` — 429

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)