People's titles and employers by role, company, location.

Use the people API search endpoint to find new prospects.

Job people.search

Your AI asks

choose input values first

telipot inspect apollo.people.search

Provider's rate

Free

Inspect· before choosing inputs

apollo.people.search

FreeYour plan

Whose account it uses

1The person asking

not needed

2Your company’s Apollo plan

3Our account

not used

Choose inputs

person_titles[] · 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 · Set false to return only strict matches for person_titles[].

No complete example input is recorded. Inspect reads the schema; it does not run the task.

What it costs

Free

no charge from the provider

For developers · inspect first

Read the schema and choose input values

telipot inspect apollo.people.search

No complete example input is recorded. Read the field notes below before building the call.

person_titles[] array	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 boolean	Set false to return only strict matches for person_titles[].
q_keywords string	Words to filter the results over.
q_person_name string	Name of the person. Matches people whose name contains every word given, independent of other filters.
person_locations[] array	Where people live: cities, US states or countries. Examples: california; ireland; chicago.
person_seniorities[] array	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[] array	Headquarters location of the person's current employer: cities, US states or countries. Examples: texas; tokyo; spain.
q_organization_domains_list[] array · at most 1000	Employer domains, current or previous, without www. or @; up to 1,000. Examples: apollo.io; microsoft.com.
contact_email_status[] array	Email statuses to include: verified, unverified, likely to engage, unavailable.
organization_ids[] array	Apollo IDs of employers to include; organization search returns them as id.
organization_num_employees_ranges[] array	Employer headcount ranges as lower,upper strings. Examples: 1,10; 250,500; 10000,20000.
revenue_range[min] integer	Minimum employer revenue, digits only (no currency symbol, comma or decimal point). Pair with revenue_range[max].
revenue_range[max] integer	Maximum employer revenue, digits only. Pair with revenue_range[min].
currently_using_all_of_technology_uids[] array	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[] array	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[] array	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[] array	Job titles in active job postings at the person's current employer. Examples: sales manager; research analyst.
organization_job_locations[] array	Locations of the jobs the person's employer is recruiting for. Examples: atlanta; japan.
organization_num_jobs_range[min] integer	Minimum number of active job postings at the employer. Pair with organization_num_jobs_range[max].
organization_num_jobs_range[max] integer	Maximum number of active job postings at the employer.
organization_job_posted_at_range[min] string	Earliest date the employer posted jobs, YYYY-MM-DD. Pair with organization_job_posted_at_range[max].
organization_job_posted_at_range[max] string	Latest date the employer posted jobs, YYYY-MM-DD.
organization_headcount_growth_past_n_months integer · 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] integer	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] integer	Maximum employer headcount growth as a whole-number percentage over the window. Needs organization_headcount_growth_past_n_months.
lookalike_organization_ids[] array · 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[] array	Exclude people whose current employer matches any of these domains, including the company's other known domains.
page integer · 1 to 500	Page to return, up to 500 pages of 100; use with per_page.
per_page integer · 1 to 100	Results per page, up to 100. Apollo caps a search at 50,000 records.

total_entries

integer

The total number of people that match your search criteria.

people

object[]

Full output schema · JSONNested fields and constraints

Output JSON Schema

{
  "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"
              }
            }
          }
        }
      }
    }
  }
}

A real answer

No example captured yet: one is recorded when telipot catalog verify passes.

People's titles and employers by role, company, location.

What it costs

For developers · inspect first

What you give it0 required

What you get backas Apollo sent it, plus whose account and the cost

A real answer