--- updatedAt: 2026-07-28T16:57:31.000Z --- Fetch the complete documentation index at: https://docs.apollo.io/llms.txt. Use this file to discover all available pages before exploring further. # Find People Using Filters ## Overview Use the people search API endpoint to find people in Apollo based on criteria such as job title, location, seniority, company, and industry. This tutorial shows how to find sales directors located in California, Oregon, or Washington. ## 1: Search for People Using Job Title and Location Filters To find sales directors located on the West Coast of the United States: 1. Call the people API search endpoint: ```http POST https://api.apollo.io/api/v1/mixed_people/api_search ``` 2. Add the following query parameters: | Parameter | Value for this Example | Notes | | :----------------- | :-------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------- | | `person_titles` | `["sales director", "director sales", "director, sales"]` | Add each job title as a separate string in the array. | | `person_locations` | `["California, US", "Oregon, US", "Washington, US"]` | Filters people by their personal location. To filter by the location of their current employer, use `organization_locations`. | | `per_page` | `5` | Sets the number of results returned per page. Enter an integer from 1 to 100. | 3. Add the following keys and values to the header of your request: 1. **Content-Type**: `application/json` 2. **Cache-Control**: `no-cache` 3. **x-api-key**: Enter your Apollo API key. ### cURL Request The following shows the example as a cURL request: ```curl curl --request POST \ --url 'https://api.apollo.io/api/v1/mixed_people/api_search?person_titles[]=sales%20director&person_titles[]=director%20sales&person_titles[]=director%2C%20sales&person_locations[]=California%2C%20US&person_locations[]=Oregon%2C%20US&person_locations[]=Washington%2C%20US&per_page=5' \ --header 'Cache-Control: no-cache' \ --header 'Content-Type: application/json' \ --header 'accept: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ### Postman Request As an example, here's how the request can be formatted in Postman. If you prefer to pass parameters via the body of the request, use the `raw` option instead of `form-data`. ![](https://storage.googleapis.com/apollo-public-assets/kb_images/api_tutorials/i6.png) ### Response Details A successful request returns a `200` response status and JSON data similar to the following response: ```json { "total_entries": 31993, "people": [ { "id": "63519a6d6fa6ba00019200f8", "first_name": "Elena", "last_name_obfuscated": "Mo***s", "title": "Director of Sales", "last_refreshed_at": "2026-05-16T08:16:08.485+00:00", "has_email": false, "has_city": true, "has_state": true, "has_country": true, "has_direct_phone": "Yes", "organization": { "name": "Northwind Systems", "has_industry": true, "has_phone": true, "has_city": true, "has_state": true, "has_country": true, "has_zip_code": true, "has_revenue": true, "has_employee_count": true } }, { "id": "67da57bcf3aa9a0001ef0500", "first_name": "Marcus", "last_name_obfuscated": "Le***n", "title": "Sales Director", "last_refreshed_at": "2026-05-10T08:39:18.742+00:00", "has_email": true, "has_city": true, "has_state": true, "has_country": true, "has_direct_phone": "Yes", "organization": { "name": "Blue Peak Analytics", "has_industry": true, "has_phone": true, "has_city": true, "has_state": true, "has_country": true, "has_zip_code": true, "has_revenue": true, "has_employee_count": true } }, { "id": "55d6d50df3e5bb19db00382b", "first_name": "Priya", "last_name_obfuscated": "Sh***h", "title": "Director, Sales", "last_refreshed_at": "2026-05-10T10:38:42.300+00:00", "has_email": false, "has_city": true, "has_state": true, "has_country": true, "has_direct_phone": "Yes", "organization": { "name": "Harborline Software", "has_industry": true, "has_phone": true, "has_city": true, "has_state": true, "has_country": true, "has_zip_code": true, "has_revenue": false, "has_employee_count": true } }, { "id": "67bbfd72fe96a70001ebb388", "first_name": "Darius", "last_name_obfuscated": "Co***e", "title": "Sales Director", "last_refreshed_at": "2026-05-08T01:30:13.928+00:00", "has_email": true, "has_city": true, "has_state": true, "has_country": true, "has_direct_phone": "Yes", "organization": { "name": "Cedar Grove Technologies", "has_industry": true, "has_phone": true, "has_city": true, "has_state": true, "has_country": true, "has_zip_code": true, "has_revenue": true, "has_employee_count": true } }, { "id": "6820ea8427ffb80001b7c115", "first_name": "Naomi", "last_name_obfuscated": "Ki***a", "title": "Director of Sales", "last_refreshed_at": "2026-05-03T23:32:52.029+00:00", "has_email": true, "has_city": true, "has_state": true, "has_country": true, "has_direct_phone": "Maybe: request direct dial via people/bulk_match", "organization": { "name": "Summit Ridge Networks", "has_industry": true, "has_phone": true, "has_city": true, "has_state": true, "has_country": true, "has_zip_code": true, "has_revenue": true, "has_employee_count": true } } ] } ``` The following table details some key elements of the API response: | Element | Description | | :--------------------- | :----------------------------------------------------------------------------------------------------------------------- | | `total_entries` | The total number of people that match the search criteria. | | `id` | The Apollo person ID. Use this value to enrich the person with the people enrichment or bulk people enrichment endpoint. | | `first_name` | The person's first name. | | `last_name_obfuscated` | An obfuscated version of the person's last name. | | `title` | The person's current job title. | | `has_email` | Indicates whether Apollo has an email address for the person. | | `has_direct_phone` | Indicates whether Apollo may have a direct phone number for the person. | | `organization` | Availability indicators for data about the person's current employer. | The people API search endpoint returns limited person and organization data. To retrieve complete person profiles, use the returned `id` values with the [people enrichment](https://docs.apollo.io/reference/people-enrichment) or [bulk people enrichment](https://docs.apollo.io/reference/bulk-people-enrichment) endpoint. For a bulk enrichment example, check out [Enrich People Data](https://docs.apollo.io/docs/enrich-people-data#3-bulk-enrich-people-using-apollo-ids).