Find People by Job Title with Apollo

Search Apollo for people matching a job title, with an optional company website and the person’s home location. Each search shows up to one limited preview, not a full profile; email addresses and phone numbers are not included.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use the exact Tool apollo-people-search-apollo through my existing Toolmu connection. If setup is needed, point me to https://toolmu.com/SKILL.md. Ask for one job title if I have not supplied it; do not substitute an example or a person name. Within my current authorization and the displayed execution terms, make at most one request with queryParams.person_titles[] set to the title I gave you, page 1 and per_page 1. If I provide a company website, extract its domain and pass it through queryParams["q_organization_domains_list[]"]; this can match a current or past employer. If I provide where the person lives, pass that as queryParams["person_locations[]"]. Leave all other filters unset. Summarize only the returned preview, using available name fragments, job title and company details; do not show internal IDs or guess hidden values. Explain that this search does not provide email addresses or phone numbers, and similar job titles may appear. A company match does not verify current employment. Report retrieval failure separately from a successful empty result. Do not retry, request another page, broaden the search, call other Tools, enrich contact details, contact the person or write to a CRM.

Task:
Search Apollo for people matching [job title]. You can narrow results by [company website link] and [city or country where they live]. Review up to one preview with the available name, job title and company. It does not include email or phone; a company match may be from past work.

Paste into your connected AI's conversation.

Connection guide

Free

Apollo

Find People by Job Title with Apollo

You receive

A preview may show an Apollo person ID, first name, partially masked surname, job title, current-employer name and Apollo’s data refresh time. It can also indicate whether Apollo holds contact, location or company information; those indicators do not contain the underlying email, phone, location or financial values.

Start with your task

Search Apollo for people matching [job title]. You can narrow results by [company website link] and [city or country where they live]. Review up to one preview with the available name, job title and company. It does not include email or phone; a company match may be from past work.

What to know

This search returns previews rather than complete profiles or revealed contact details. Related titles can match, and an employer-domain filter may match current or past employment. A result and refresh time do not independently verify identity, current employment or purchasing authority. A requested page may be partial or empty; failure or no results does not prove that nobody matches.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
Search settings`queryParams`	`object`	Optional	Optional settings for a page of person previews. Choose relevant title, person or employer filters and optional pagination. This search does not reveal email addresses or phone numbers.
Page number`queryParams.page`	`integer`	Optional	Optional integer from 1 to 500. Selects the requested page together with the page-size setting; it does not fetch later pages automatically. Maximum `500`
Requested previews per page`queryParams.per_page`	`integer`	Optional	Optional integer from 1 to 100. Requests up to this many previews on the selected page; the page may contain fewer records or be empty. Maximum `100`
Keyword filter`queryParams.q_keywords`	`string`	Optional	Optional words for filtering person-search results. Use the job-title list when you want to search by role; this is not a dedicated person-name lookup.
Job titles`queryParams.person_titles[]`	`array`	Optional	Optional list of job titles. People may match any listed title, including related title terms. The similar-title setting controls broader title matching; a match does not verify the person’s current role.
One job title`queryParams.person_titles[][]`	`string`	—	One nonempty job-title string in the list. In the example, use the actual title supplied by the user. Minimum length `1`
Employer organization IDs`queryParams.organization_ids[]`	`array`	Optional	Optional list of existing Apollo organization IDs to restrict the person search. Supply IDs you already have; selecting this filter does not look up organization IDs.
One organization ID`queryParams.organization_ids[][]`	`string`	—	One nonempty Apollo organization-ID string. It is an organization identifier, not a person ID or a domain name. Minimum length `1`
Person residence locations`queryParams.person_locations[]`	`array`	Optional	Optional list of cities, US states or countries where people live. This differs from employer headquarters and job-posting locations; location-presence indicators in previews do not reveal the actual location.
One residence location`queryParams.person_locations[][]`	`string`	—	One nonempty residence-location string, such as a city, US state or country. Minimum length `1`
Maximum employer revenue`queryParams.revenue_range[max]`	`integer`	Optional	Optional nonnegative integer upper revenue bound for employer filtering. Use whole numeric figures without commas, currency symbols or decimals. No currency is specified, and this filter does not reveal actual revenue. Minimum `0` Maximum `9007199254740991`
Minimum employer revenue`queryParams.revenue_range[min]`	`integer`	Optional	Optional nonnegative integer lower revenue bound for employer filtering. Use whole numeric figures without commas, currency symbols or decimals. No currency is specified, and this filter does not reveal actual revenue. Minimum `0` Maximum `9007199254740991`
Current-role seniority levels`queryParams.person_seniorities[]`	`array`	Optional	Optional list of seniority labels: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern. Multiple labels broaden the matches. These refer to currently held titles, not past titles or independently verified purchasing authority.
One seniority label`queryParams.person_seniorities[][]`	`string`	—	One nonempty seniority-label string from the documented choices. Minimum length `1`
Email-status filters`queryParams.contact_email_status[]`	`array`	Optional	Optional list of source email-status labels: verified, unverified, likely to engage, unavailable. Multiple labels broaden the matches. Filtering by status does not return an email address or establish deliverability.
One email-status label`queryParams.contact_email_status[][]`	`string`	—	One nonempty source email-status string. Keep its source meaning separate from a revealed address or a delivery test. Minimum length `1`
Include similar job titles`queryParams.include_similar_titles`	`boolean`	Optional	Optional boolean controlling whether similar titles can match the job-title list. Set false to request narrower title matching; this does not independently verify role, identity or purchasing authority.
Current-employer headquarters`queryParams.organization_locations[]`	`array`	Optional	Optional list of headquarters locations for the person’s current employer. This does not mean branch offices, the person’s residence or hiring locations, and does not reveal headquarters values in the preview.
One headquarters location`queryParams.organization_locations[][]`	`string`	—	One nonempty current-employer headquarters-location string. Minimum length `1`
Employer hiring titles`queryParams.q_organization_job_titles[]`	`array`	Optional	Optional list of titles in active job postings at the person’s current employer. Results remain person previews, not job postings or independently verified open vacancies.
One hiring title`queryParams.q_organization_job_titles[][]`	`string`	—	One nonempty title string for filtering employer job postings. Minimum length `1`
Employer hiring locations`queryParams.organization_job_locations[]`	`array`	Optional	Optional list of locations in active employer job postings. These are hiring locations, separate from a person’s residence and employer headquarters; the search does not return a job list.
One hiring location`queryParams.organization_job_locations[][]`	`string`	—	One nonempty employer job-posting location string. Minimum length `1`
Current or past employer domains`queryParams.q_organization_domains_list[]`	`array`	Optional	Optional list of employer domains without www. or @. Apollo documents up to 1,000 per request. A domain may match current or past employment; the current-employer name returned in a preview may differ from the supplied domain.
One employer domain`queryParams.q_organization_domains_list[][]`	`string`	—	One nonempty employer-domain string, without www. or @. Do not assume it identifies the person’s current employer. Minimum length `1`
Maximum employer job count`queryParams.organization_num_jobs_range[max]`	`integer`	Optional	Optional nonnegative integer upper bound for the current employer’s active job-posting count. It filters people; it does not return those jobs or independently verify current vacancies. Minimum `0` Maximum `9007199254740991`
Minimum employer job count`queryParams.organization_num_jobs_range[min]`	`integer`	Optional	Optional nonnegative integer lower bound for the current employer’s active job-posting count. It filters people; it does not return those jobs or independently verify current vacancies. Minimum `0` Maximum `9007199254740991`
Current-employer headcount ranges`queryParams.organization_num_employees_ranges[]`	`array`	Optional	Optional list of employer headcount ranges written as lower,upper strings, such as 1,10 or 250,500. Multiple ranges broaden the matches. This filter does not reveal the employer’s actual headcount in a preview.
One headcount range`queryParams.organization_num_employees_ranges[][]`	`string`	—	One nonempty lower,upper range string, such as 250,500. Minimum length `1`
Latest employer job-posting date`queryParams.organization_job_posted_at_range[max]`	`string`	Optional	Optional upper date for employer job postings, using YYYY-MM-DD. It filters people by employer recruiting context; it is not the person’s data refresh date or proof that a vacancy remains open.
Earliest employer job-posting date`queryParams.organization_job_posted_at_range[min]`	`string`	Optional	Optional lower date for employer job postings, using YYYY-MM-DD. It filters people by employer recruiting context; it is not the person’s data refresh date or proof that a vacancy remains open.
Employer uses all listed technologies`queryParams.currently_using_all_of_technology_uids[]`	`array`	Optional	Optional list requiring the current employer to match all supplied technology identifiers in Apollo’s records. Identifiers use underscores in place of spaces or periods. Matching does not independently verify current use or return a complete technology inventory.
One required technology identifier`queryParams.currently_using_all_of_technology_uids[][]`	`string`	—	One nonempty technology identifier in the all-listed condition. Minimum length `1`
Employer uses any listed technology`queryParams.currently_using_any_of_technology_uids[]`	`array`	Optional	Optional list matching a current employer recorded as using any supplied technology. Identifiers use underscores in place of spaces or periods. Matching does not independently verify current use or return a complete technology inventory.
One alternative technology identifier`queryParams.currently_using_any_of_technology_uids[][]`	`string`	—	One nonempty technology identifier in the any-listed condition. Minimum length `1`
Exclude employers using listed technologies`queryParams.currently_not_using_any_of_technology_uids[]`	`array`	Optional	Optional list excluding people whose current employer is recorded as using any supplied technology. Identifiers use underscores in place of spaces or periods. Exclusion does not independently verify the absence of a technology.
One excluded technology identifier`queryParams.currently_not_using_any_of_technology_uids[][]`	`string`	—	One nonempty technology identifier whose recorded use at the current employer triggers exclusion. Minimum length `1`

View raw JSON

{
  "type": "object",
  "required": [],
  "properties": {
    "queryParams": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "page": {
          "type": "integer",
          "maximum": 500,
          "description": "Optional integer from 1 to 500. Selects the requested page together with the page-size setting; it does not fetch later pages automatically.",
          "exclusiveMinimum": 0
        },
        "per_page": {
          "type": "integer",
          "maximum": 100,
          "description": "Optional integer from 1 to 100. Requests up to this many previews on the selected page; the page may contain fewer records or be empty.",
          "exclusiveMinimum": 0
        },
        "q_keywords": {
          "type": "string",
          "description": "Optional words for filtering person-search results. Use the job-title list when you want to search by role; this is not a dedicated person-name lookup."
        },
        "person_titles[]": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "description": "Optional list of job titles. People may match any listed title, including related title terms. The similar-title setting controls broader title matching; a match does not verify the person’s current role."
        },
        "organization_ids[]": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "description": "Optional list of existing Apollo organization IDs to restrict the person search. Supply IDs you already have; selecting this filter does not look up organization IDs."
        },
        "person_locations[]": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "description": "Optional list of cities, US states or countries where people live. This differs from employer headquarters and job-posting locations; location-presence indicators in previews do not reveal the actual location."
        },
        "revenue_range[max]": {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        "revenue_range[min]": {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        "person_seniorities[]": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "description": "Optional list of seniority labels: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern. Multiple labels broaden the matches. These refer to currently held titles, not past titles or independently verified purchasing authority."
        },
        "contact_email_status[]": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "description": "Optional list of source email-status labels: verified, unverified, likely to engage, unavailable. Multiple labels broaden the matches. Filtering by status does not return an email address or establish deliverability."
        },
        "include_similar_titles": {
          "type": "boolean",
          "description": "Optional boolean controlling whether similar titles can match the job-title list. Set false to request narrower title matching; this does not independently verify role, identity or purchasing authority."
        },
        "organization_locations[]": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "description": "Optional list of headquarters locations for the person’s current employer. This does not mean branch offices, the person’s residence or hiring locations, and does not reveal headquarters values in the preview."
        },
        "q_organization_job_titles[]": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "description": "Optional list of titles in active job postings at the person’s current employer. Results remain person previews, not job postings or independently verified open vacancies."
        },
        "organization_job_locations[]": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "description": "Optional list of locations in active employer job postings. These are hiring locations, separate from a person’s residence and employer headquarters; the search does not return a job list."
        },
        "q_organization_domains_list[]": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "description": "Optional list of employer domains without www. or @. Apollo documents up to 1,000 per request. A domain may match current or past employment; the current-employer name returned in a preview may differ from the supplied domain."
        },
        "organization_num_jobs_range[max]": {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        "organization_num_jobs_range[min]": {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        "organization_num_employees_ranges[]": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "description": "Optional list of employer headcount ranges written as lower,upper strings, such as 1,10 or 250,500. Multiple ranges broaden the matches. This filter does not reveal the employer’s actual headcount in a preview."
        },
        "organization_job_posted_at_range[max]": {
          "type": "string",
          "description": "Optional upper date for employer job postings, using YYYY-MM-DD. It filters people by employer recruiting context; it is not the person’s data refresh date or proof that a vacancy remains open."
        },
        "organization_job_posted_at_range[min]": {
          "type": "string",
          "description": "Optional lower date for employer job postings, using YYYY-MM-DD. It filters people by employer recruiting context; it is not the person’s data refresh date or proof that a vacancy remains open."
        },
        "currently_using_all_of_technology_uids[]": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "currently_using_any_of_technology_uids[]": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "currently_not_using_any_of_technology_uids[]": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Employer revenue filters do not specify a currency; do not assume US dollars. A job-posting date filter describes employer postings, while the refresh time in a person preview describes when Apollo refreshed that person’s data.

Official Apollo documentation

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

No. This search shows a limited preview and does not reveal email addresses or phone numbers, even if Apollo indicates those details may exist. A notice that details exist is not permission to contact someone.

Find People by Job Title with Apollo

Find People by Job Title with Apollo

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Connect your AI assistant

Search by job title

Add a company website and home location

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Connect your AI assistant

Search by job title

Add a company website and home location

Questions about this tool.

Will I get an email or phone number?

Does a company website prove someone still works there?

Does the location mean where the person works?