# apollo.people.search People's titles and employers by role, company, location > Use the people API search endpoint to find new prospects. Page: https://telipot.com/catalog/tasks/apollo.people.search · Markdown: https://telipot.com/catalog/tasks/apollo.people.search/md · JSON: https://telipot.com/catalog/tasks/apollo.people.search/json | Field | Value | | --- | --- | | provider | [Apollo](https://telipot.com/catalog/providers/apollo) `apollo` | | capability | [`people.search`](https://telipot.com/catalog/capabilities/people.search) | | kind | data | | tier | core | | price | Free (Free from the tool) | | identity | Your plan | | auth | `api_key · in header as x-api-key` | | scope | any_account | | principal | organization | | required_scopes | none | | retention | standard | | route | `POST https://api.apollo.io/api/v1/mixed_people/api_search` | | verification | Untestable. Answers with named people, their titles and employers; a contact lookup, so it has no test request. | | status | live | | docs | https://docs.apollo.io/reference/people-api-search | ## Inspect first No complete example input is recorded. Read the schema and field notes before building the call. ```bash telipot inspect apollo.people.search ``` ```bash curl https://api.telipot.com/v1/tasks/apollo.people.search \ -H "Authorization: Bearer $TELIPOT_TOKEN" ``` ## Input | Field | In | Type | Required | Constraints | Note | | --- | --- | --- | --- | --- | --- | | `person_titles[]` | queryParams | array | no | | Job titles to find; a person matches any one of them, and similar titles are included unless include_similar_titles is false. Pair with person_seniorities[]. Examples: sales development representative; marketing manager; research analyst. | | `include_similar_titles` | queryParams | boolean | no | | Set false to return only strict matches for person_titles[]. | | `q_keywords` | queryParams | string | no | | Words to filter the results over. | | `q_person_name` | queryParams | string | no | | Name of the person. Matches people whose name contains every word given, independent of other filters. | | `person_locations[]` | queryParams | array | no | | Where people live: cities, US states or countries. Examples: california; ireland; chicago. | | `person_seniorities[]` | queryParams | array | no | | Seniority of the person's current title; a person matches any one given. Options: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern. | | `organization_locations[]` | queryParams | array | no | | Headquarters location of the person's current employer: cities, US states or countries. Examples: texas; tokyo; spain. | | `q_organization_domains_list[]` | queryParams | array | no | at most 1000 | Employer domains, current or previous, without www. or @; up to 1,000. Examples: apollo.io; microsoft.com. | | `contact_email_status[]` | queryParams | array | no | | Email statuses to include: verified, unverified, likely to engage, unavailable. | | `organization_ids[]` | queryParams | array | no | | Apollo IDs of employers to include; organization search returns them as id. | | `organization_num_employees_ranges[]` | queryParams | array | no | | Employer headcount ranges as lower,upper strings. Examples: 1,10; 250,500; 10000,20000. | | `revenue_range[min]` | queryParams | integer | no | | Minimum employer revenue, digits only (no currency symbol, comma or decimal point). Pair with revenue_range[max]. | | `revenue_range[max]` | queryParams | integer | no | | Maximum employer revenue, digits only. Pair with revenue_range[min]. | | `currently_using_all_of_technology_uids[]` | queryParams | array | no | | Employer must use all of these. Technology uids; replace spaces and periods with underscores. Apollo filters on 1,500+ technologies. Examples: salesforce; google_analytics; wordpress_org. | | `currently_using_any_of_technology_uids[]` | queryParams | array | no | | Employer must use any of these. Technology uids; replace spaces and periods with underscores. Apollo filters on 1,500+ technologies. Examples: salesforce; google_analytics; wordpress_org. | | `currently_not_using_any_of_technology_uids[]` | queryParams | array | no | | Exclude people whose employer uses any of these. Technology uids; replace spaces and periods with underscores. Apollo filters on 1,500+ technologies. Examples: salesforce; google_analytics; wordpress_org. | | `q_organization_job_titles[]` | queryParams | array | no | | Job titles in active job postings at the person's current employer. Examples: sales manager; research analyst. | | `organization_job_locations[]` | queryParams | array | no | | Locations of the jobs the person's employer is recruiting for. Examples: atlanta; japan. | | `organization_num_jobs_range[min]` | queryParams | integer | no | | Minimum number of active job postings at the employer. Pair with organization_num_jobs_range[max]. | | `organization_num_jobs_range[max]` | queryParams | integer | no | | Maximum number of active job postings at the employer. | | `organization_job_posted_at_range[min]` | queryParams | string | no | | Earliest date the employer posted jobs, YYYY-MM-DD. Pair with organization_job_posted_at_range[max]. | | `organization_job_posted_at_range[max]` | queryParams | string | no | | Latest date the employer posted jobs, YYYY-MM-DD. | | `organization_headcount_growth_past_n_months` | queryParams | integer | no | one of 6, 12, 24 | Trailing window in months for employer headcount growth. Has no effect unless sent with organization_headcount_growth_range[min] or [max]. | | `organization_headcount_growth_range[min]` | queryParams | integer | no | | Minimum employer headcount growth as a whole-number percentage over the window; 10 means 10%. Needs organization_headcount_growth_past_n_months. | | `organization_headcount_growth_range[max]` | queryParams | integer | no | | Maximum employer headcount growth as a whole-number percentage over the window. Needs organization_headcount_growth_past_n_months. | | `lookalike_organization_ids[]` | queryParams | array | no | at most 5 | Apollo IDs of up to 5 seed companies; results narrow to people at similar companies and exclude the seeds. A seed with no lookalike data returns no results. | | `not_organization_websites_list[]` | queryParams | array | no | | Exclude people whose current employer matches any of these domains, including the company's other known domains. | | `page` | queryParams | integer | no | 1 to 500 | Page to return, up to 500 pages of 100; use with per_page. | | `per_page` | queryParams | integer | no | 1 to 100 | Results per page, up to 100. Apollo caps a search at 50,000 records. | ## Input schema ```json { "type": "object", "properties": { "person_titles[]": { "type": "array", "description": "Job titles to find; a person matches any one of them, and similar titles are included unless include_similar_titles is false. Pair with person_seniorities[]. Examples: sales development representative; marketing manager; research analyst.", "examples": [ [ "marketing manager" ] ] }, "include_similar_titles": { "type": "boolean", "description": "Set false to return only strict matches for person_titles[]." }, "q_keywords": { "type": "string", "description": "Words to filter the results over." }, "q_person_name": { "type": "string", "description": "Name of the person. Matches people whose name contains every word given, independent of other filters." }, "person_locations[]": { "type": "array", "description": "Where people live: cities, US states or countries. Examples: california; ireland; chicago." }, "person_seniorities[]": { "type": "array", "description": "Seniority of the person's current title; a person matches any one given. Options: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern." }, "organization_locations[]": { "type": "array", "description": "Headquarters location of the person's current employer: cities, US states or countries. Examples: texas; tokyo; spain." }, "q_organization_domains_list[]": { "type": "array", "description": "Employer domains, current or previous, without www. or @; up to 1,000. Examples: apollo.io; microsoft.com.", "examples": [ [ "stripe.com" ] ], "maxItems": 1000 }, "contact_email_status[]": { "type": "array", "description": "Email statuses to include: verified, unverified, likely to engage, unavailable." }, "organization_ids[]": { "type": "array", "description": "Apollo IDs of employers to include; organization search returns them as id." }, "organization_num_employees_ranges[]": { "type": "array", "description": "Employer headcount ranges as lower,upper strings. Examples: 1,10; 250,500; 10000,20000." }, "revenue_range[min]": { "type": "integer", "description": "Minimum employer revenue, digits only (no currency symbol, comma or decimal point). Pair with revenue_range[max]." }, "revenue_range[max]": { "type": "integer", "description": "Maximum employer revenue, digits only. Pair with revenue_range[min]." }, "currently_using_all_of_technology_uids[]": { "type": "array", "description": "Employer must use all of these. Technology uids; replace spaces and periods with underscores. Apollo filters on 1,500+ technologies. Examples: salesforce; google_analytics; wordpress_org." }, "currently_using_any_of_technology_uids[]": { "type": "array", "description": "Employer must use any of these. Technology uids; replace spaces and periods with underscores. Apollo filters on 1,500+ technologies. Examples: salesforce; google_analytics; wordpress_org." }, "currently_not_using_any_of_technology_uids[]": { "type": "array", "description": "Exclude people whose employer uses any of these. Technology uids; replace spaces and periods with underscores. Apollo filters on 1,500+ technologies. Examples: salesforce; google_analytics; wordpress_org." }, "q_organization_job_titles[]": { "type": "array", "description": "Job titles in active job postings at the person's current employer. Examples: sales manager; research analyst." }, "organization_job_locations[]": { "type": "array", "description": "Locations of the jobs the person's employer is recruiting for. Examples: atlanta; japan." }, "organization_num_jobs_range[min]": { "type": "integer", "description": "Minimum number of active job postings at the employer. Pair with organization_num_jobs_range[max]." }, "organization_num_jobs_range[max]": { "type": "integer", "description": "Maximum number of active job postings at the employer." }, "organization_job_posted_at_range[min]": { "type": "string", "description": "Earliest date the employer posted jobs, YYYY-MM-DD. Pair with organization_job_posted_at_range[max].", "examples": [ "2025-07-25" ] }, "organization_job_posted_at_range[max]": { "type": "string", "description": "Latest date the employer posted jobs, YYYY-MM-DD.", "examples": [ "2025-09-25" ] }, "organization_headcount_growth_past_n_months": { "type": "integer", "description": "Trailing window in months for employer headcount growth. Has no effect unless sent with organization_headcount_growth_range[min] or [max].", "enum": [ 6, 12, 24 ] }, "organization_headcount_growth_range[min]": { "type": "integer", "description": "Minimum employer headcount growth as a whole-number percentage over the window; 10 means 10%. Needs organization_headcount_growth_past_n_months." }, "organization_headcount_growth_range[max]": { "type": "integer", "description": "Maximum employer headcount growth as a whole-number percentage over the window. Needs organization_headcount_growth_past_n_months." }, "lookalike_organization_ids[]": { "type": "array", "description": "Apollo IDs of up to 5 seed companies; results narrow to people at similar companies and exclude the seeds. A seed with no lookalike data returns no results.", "maxItems": 5 }, "not_organization_websites_list[]": { "type": "array", "description": "Exclude people whose current employer matches any of these domains, including the company's other known domains." }, "page": { "type": "integer", "description": "Page to return, up to 500 pages of 100; use with per_page.", "examples": [ 1 ], "minimum": 1, "maximum": 500 }, "per_page": { "type": "integer", "description": "Results per page, up to 100. Apollo caps a search at 50,000 records.", "examples": [ 10 ], "minimum": 1, "maximum": 100 } }, "additionalProperties": false } ``` ## Output schema ```json { "type": "object", "properties": { "total_entries": { "type": "integer", "description": "The total number of people that match your search criteria." }, "people": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "first_name": { "type": "string" }, "last_name_obfuscated": { "type": "string", "description": "First 2 characters, asterisks, then the last character." }, "title": { "type": [ "string", "null" ] }, "last_refreshed_at": { "type": "string" }, "has_email": { "type": "boolean" }, "has_city": { "type": "boolean" }, "has_state": { "type": "boolean" }, "has_country": { "type": "boolean" }, "has_direct_phone": { "type": "string", "description": "Yes, or a Maybe note when Apollo is uncertain." }, "organization": { "type": "object", "properties": { "name": { "type": "string" }, "has_industry": { "type": "boolean" }, "has_phone": { "type": "boolean" }, "has_city": { "type": "boolean" }, "has_state": { "type": "boolean" }, "has_country": { "type": "boolean" }, "has_zip_code": { "type": "boolean" }, "has_revenue": { "type": "boolean" }, "has_employee_count": { "type": "boolean" } } } } } } } } ```