Apollo People API Search
https://api.sandbase.ai/v1/api/apollo/people-searchUse the People API Search endpoint to find net new people in the Apollo database. Several filters are available to help narrow your search. This endpoint is optimized for API usage and does not consume credits.
- Price
- $0.02USD / call
- Method
- POST
- Response
- JSON
- Parameters
- 0 required · 23 optional
Production route
Try the model
Playground
Input
The email statuses for the people you want to find. You can add multiple statuses to expand your search. The statuses you can search include: verified unverified likely to engage unavailable
Exclude people from your search based on any of the technologies their current employer uses. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data from multiple sources. This data is updated regularly. Check out the full list of supported technologies by downloading
Find people based on all of the technologies their current employer uses. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data from multiple sources. This data is updated regularly. Check out the full list of supported technologies by downloading this CSV file . Use
Find people based on any of the technologies their current employer uses. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data from multiple sources. This data is updated regularly. Check out the full list of supported technologies by downloading this CSV file . Use
This parameter determines whether people with job titles similar to the titles you define in the person_titles[] parameter are returned in the response. Set this parameter to false when using person_titles[] to return only strict matches for job titles.
The Apollo IDs for the companies (employers) you want to include in your search results. Each company in the Apollo database is assigned a unique ID. To find IDs, call the Organization Search endpoint and identify the values for organization_id. Example: 5e66b6381e05b4008c8331b8
The locations of the jobs being actively recruited by the person's employer. Examples: atlanta; japan
The latest date when jobs were posted by the person's current employer. Use this parameter in combination with organization_job_posted_at_range[min] to set a date range for when jobs posted. Example: 2025-09-25
The earliest date when jobs were posted by the person's current employer. Use this parameter in combination with organization_job_posted_at_range[max] to set a date range for when jobs posted. Example: 2025-07-25
The location of the company headquarters for a person's current employer. You can search across cities, US states, and countries. If a company has several office locations, results are still based on the headquarters location. For example, if you search chicago but a company's HQ location is in bost
The number range of employees working for the person's current company. This enables you to find people based on the headcount of their employer. You can add multiple ranges to expand your search results. Each range you add needs to be a string, with the upper and lower numbers of the range separate
The maximum number of job postings active at the person's current employer. Use this parameter in combination with organization_num_jobs_range[min] to set a job postings range. Examples: 50; 500
The minimum number of job postings active at the person's current employer. Use this parameter in combination with organization_num_jobs_range[max] to set a job postings range. Examples: 50; 500
The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the per_page parameter to make search results for navigable and improve the performance of the endpoint. Example: 4
The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the page parameter to search the different pages of data. Example: 10
The location where people live. You can search across cities, US states, and countries. To find people based on the headquarters locations of their current employer, use the organization_locations parameter. Examples: california; ireland; chicago
The job seniority that people hold within their current employer. This enables you to find people that currently hold positions at certain reporting levels, such as Director level or senior IC level. For a person to be included in search results, they only need to match 1 of the seniorities you add.
Job titles held by the people you want to find. For a person to be included in search results, they only need to match 1 of the job titles you add. Adding more job titles expands your search results. Results also include job titles with the same terms, even if they are not exact matches. For example
A string of words over which we want to filter the results.
The domain name for the person's employer. This can be the current employer or a previous employer. Do not include www., the @ symbol, or similar. This parameter accepts up to 1,000 domains in a single request. Examples: apollo.io; microsoft.com
The job titles that are listed in active job postings at the person's current employer. Examples: sales manager; research analyst
The maximum revenue the person's current employer generates. Use this parameter in combination with revenue_range[min] to set a revenue range. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 500000; 1500000
The minimum revenue the person's current employer generates. Use this parameter in combination with revenue_range[max] to set a revenue range. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 500000; 1500000
OutputReady
Your output will appear here
Complete the inputs, then click Run.
Model card
Specifications
Pricing
- Base price
- $0.02 / run
Request & response
- Method
- POST
- Request body
- application/json
- Response
- application/json
- Execution
- sync
Parameters
- contact_email_status[]
- array · optional
- currently_not_using_any_of_technology_uids[]
- array · optional
- currently_using_all_of_technology_uids[]
- array · optional
- currently_using_any_of_technology_uids[]
- array · optional
- include_similar_titles
- boolean · optional
- organization_ids[]
- array · optional
- organization_job_locations[]
- array · optional
- organization_job_posted_at_range[max]
- string · optional
- organization_job_posted_at_range[min]
- string · optional
- organization_locations[]
- array · optional
- organization_num_employees_ranges[]
- array · optional
- organization_num_jobs_range[max]
- integer · optional
- More
- +11 optional parameters
Access
- Provider
- Apollo
- API
- Platform API
- Base URL
- https://api.sandbase.ai
- Endpoint
- /v1/api/apollo/people-search
- Authentication
- Bearer API key
API README
Apollo People API Search API
Use the People API Search endpoint to find net new people in the Apollo database. Several filters are available to help narrow your search. This endpoint is optimized for API usage and does not consume credits.
The response is the official Apollo API response, unchanged.
Request
curl -X POST "https://api.sandbase.ai/v1/run" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "apollo/people-search"}'
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
contact_email_status[] | array | No | The email statuses for the people you want to find. You can add multiple statuses to expand your search. The statuses you can search include: verified unverifie |
currently_not_using_any_of_technology_uids[] | array | No | Exclude people from your search based on any of the technologies their current employer uses. Apollo supports filtering by 1,500+ technologies. Apollo calculate |
currently_using_all_of_technology_uids[] | array | No | Find people based on all of the technologies their current employer uses. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data |
currently_using_any_of_technology_uids[] | array | No | Find people based on any of the technologies their current employer uses. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data |
include_similar_titles | boolean | No | This parameter determines whether people with job titles similar to the titles you define in the person_titles[] parameter are returned in the response. Set thi |
organization_ids[] | array | No | The Apollo IDs for the companies (employers) you want to include in your search results. Each company in the Apollo database is assigned a unique ID. To find ID |
organization_job_locations[] | array | No | The locations of the jobs being actively recruited by the person's employer. Examples: atlanta; japan |
organization_job_posted_at_range[max] | string | No | The latest date when jobs were posted by the person's current employer. Use this parameter in combination with organization_job_posted_at_range[min] to set a da |
organization_job_posted_at_range[min] | string | No | The earliest date when jobs were posted by the person's current employer. Use this parameter in combination with organization_job_posted_at_range[max] to set a |
organization_locations[] | array | No | The location of the company headquarters for a person's current employer. You can search across cities, US states, and countries. If a company has several offic |
organization_num_employees_ranges[] | array | No | The number range of employees working for the person's current company. This enables you to find people based on the headcount of their employer. You can add mu |
organization_num_jobs_range[max] | integer | No | The maximum number of job postings active at the person's current employer. Use this parameter in combination with organization_num_jobs_range[min] to set a job |
organization_num_jobs_range[min] | integer | No | The minimum number of job postings active at the person's current employer. Use this parameter in combination with organization_num_jobs_range[max] to set a job |
page | integer | No | The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the per_page parameter to make search results for navigable |
per_page | integer | No | The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the page pa |
person_locations[] | array | No | The location where people live. You can search across cities, US states, and countries. To find people based on the headquarters locations of their current empl |
person_seniorities[] | array | No | The job seniority that people hold within their current employer. This enables you to find people that currently hold positions at certain reporting levels, suc |
person_titles[] | array | No | Job titles held by the people you want to find. For a person to be included in search results, they only need to match 1 of the job titles you add. Adding more |
q_keywords | string | No | A string of words over which we want to filter the results. |
q_organization_domains_list[] | array | No | The domain name for the person's employer. This can be the current employer or a previous employer. Do not include www., the @ symbol, or similar. This paramete |
q_organization_job_titles[] | array | No | The job titles that are listed in active job postings at the person's current employer. Examples: sales manager; research analyst |
revenue_range[max] | integer | No | The maximum revenue the person's current employer generates. Use this parameter in combination with revenue_range[min] to set a revenue range. Do not enter curr |
revenue_range[min] | integer | No | The minimum revenue the person's current employer generates. Use this parameter in combination with revenue_range[max] to set a revenue range. Do not enter curr |
Pricing
Flat price per call. Failed calls are not charged.
Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/apollo/people-search" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{}
SANDBASE_JSON
)
printf '%s\n' "$result"Explore more
Related APIs
| API | Price | Response | Released |
|---|---|---|---|
Apollo People API SearchThis API Apollo | $0.02 per call | JSON | Oct 30, 2026 |
Apollo | From $0.03 per call | JSON | Oct 30, 2026 |
Apollo | $0.03 per call | JSON | Aug 10, 2026 |
Apollo | $0.03 per call | JSON | Aug 10, 2026 |
Apollo | $0.03 per call | JSON | Aug 10, 2026 |
Apollo | $0.03 per call | JSON | Aug 10, 2026 |
Questions
FAQ
How do I use the Apollo People API Search API?
Send a POST request to https://api.sandbase.ai/v1/api/apollo/people-search with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
How much does the Apollo People API Search API cost?
$0.02 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
What parameters does the Apollo People API Search API accept?
No parameters are required. Optional: contact_email_status[] (array), currently_not_using_any_of_technology_uids[] (array), currently_using_all_of_technology_uids[] (array), currently_using_any_of_technology_uids[] (array), include_similar_titles (boolean) and organization_ids[] (array) and 17 more. The Parameters table and the Playground on this page list every field.
What does the Apollo People API Search API return?
A JSON response returned in the same HTTP request (synchronous).
Do I need a Apollo developer account or API key?
No. Apollo People API Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Apollo API access separately.