{
  "url": "https://telipot.com/catalog/tasks/apollo.people.search",
  "id": "apollo.people.search",
  "name": "People's titles and employers by role, company, location",
  "provider": {
    "slug": "apollo",
    "name": "Apollo"
  },
  "capability": "people.search",
  "platform": "people",
  "kind": "data",
  "tier": "core",
  "identity": "key",
  "identityLabel": "Your plan",
  "price": {
    "amount": "Free",
    "state": "free",
    "label": "Free",
    "detail": "Free from the tool",
    "type": "free"
  },
  "providers": 1,
  "retention": "standard",
  "runsOn": "free",
  "live": true,
  "summary": "Use the people API search endpoint to find new prospects.",
  "method": "POST",
  "path": "/mixed_people/api_search",
  "host": "https://api.apollo.io/api/v1",
  "docsUrl": "https://docs.apollo.io/reference/people-api-search",
  "auth": {
    "scheme": "api_key",
    "label": "api_key · in header as x-api-key",
    "short": "api_key · x-api-key"
  },
  "scope": "any_account",
  "principal": "organization",
  "requiredScopes": [],
  "verification": {
    "state": "untestable",
    "label": "Untestable",
    "detail": "Answers with named people, their titles and employers; a contact lookup, so it has no test request."
  },
  "input": [
    {
      "name": "person_titles[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "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."
    },
    {
      "name": "include_similar_titles",
      "location": "queryParams",
      "type": "boolean",
      "required": false,
      "constraints": [],
      "note": "Set false to return only strict matches for person_titles[]."
    },
    {
      "name": "q_keywords",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Words to filter the results over."
    },
    {
      "name": "q_person_name",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Name of the person. Matches people whose name contains every word given, independent of other filters."
    },
    {
      "name": "person_locations[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "Where people live: cities, US states or countries. Examples: california; ireland; chicago."
    },
    {
      "name": "person_seniorities[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "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."
    },
    {
      "name": "organization_locations[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "Headquarters location of the person's current employer: cities, US states or countries. Examples: texas; tokyo; spain."
    },
    {
      "name": "q_organization_domains_list[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [
        "at most 1000"
      ],
      "note": "Employer domains, current or previous, without www. or @; up to 1,000. Examples: apollo.io; microsoft.com."
    },
    {
      "name": "contact_email_status[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "Email statuses to include: verified, unverified, likely to engage, unavailable."
    },
    {
      "name": "organization_ids[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "Apollo IDs of employers to include; organization search returns them as id."
    },
    {
      "name": "organization_num_employees_ranges[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "Employer headcount ranges as lower,upper strings. Examples: 1,10; 250,500; 10000,20000."
    },
    {
      "name": "revenue_range[min]",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [],
      "note": "Minimum employer revenue, digits only (no currency symbol, comma or decimal point). Pair with revenue_range[max]."
    },
    {
      "name": "revenue_range[max]",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [],
      "note": "Maximum employer revenue, digits only. Pair with revenue_range[min]."
    },
    {
      "name": "currently_using_all_of_technology_uids[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "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."
    },
    {
      "name": "currently_using_any_of_technology_uids[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "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."
    },
    {
      "name": "currently_not_using_any_of_technology_uids[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "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."
    },
    {
      "name": "q_organization_job_titles[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "Job titles in active job postings at the person's current employer. Examples: sales manager; research analyst."
    },
    {
      "name": "organization_job_locations[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "Locations of the jobs the person's employer is recruiting for. Examples: atlanta; japan."
    },
    {
      "name": "organization_num_jobs_range[min]",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [],
      "note": "Minimum number of active job postings at the employer. Pair with organization_num_jobs_range[max]."
    },
    {
      "name": "organization_num_jobs_range[max]",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [],
      "note": "Maximum number of active job postings at the employer."
    },
    {
      "name": "organization_job_posted_at_range[min]",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Earliest date the employer posted jobs, YYYY-MM-DD. Pair with organization_job_posted_at_range[max]."
    },
    {
      "name": "organization_job_posted_at_range[max]",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Latest date the employer posted jobs, YYYY-MM-DD."
    },
    {
      "name": "organization_headcount_growth_past_n_months",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [
        "one of 6, 12, 24"
      ],
      "note": "Trailing window in months for employer headcount growth. Has no effect unless sent with organization_headcount_growth_range[min] or [max]."
    },
    {
      "name": "organization_headcount_growth_range[min]",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [],
      "note": "Minimum employer headcount growth as a whole-number percentage over the window; 10 means 10%. Needs organization_headcount_growth_past_n_months."
    },
    {
      "name": "organization_headcount_growth_range[max]",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [],
      "note": "Maximum employer headcount growth as a whole-number percentage over the window. Needs organization_headcount_growth_past_n_months."
    },
    {
      "name": "lookalike_organization_ids[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [
        "at most 5"
      ],
      "note": "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."
    },
    {
      "name": "not_organization_websites_list[]",
      "location": "queryParams",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "Exclude people whose current employer matches any of these domains, including the company's other known domains."
    },
    {
      "name": "page",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [
        "1 to 500"
      ],
      "note": "Page to return, up to 500 pages of 100; use with per_page."
    },
    {
      "name": "per_page",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [
        "1 to 100"
      ],
      "note": "Results per page, up to 100. Apollo caps a search at 50,000 records."
    }
  ],
  "sampleInput": {},
  "inputSchema": {
    "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": [
    {
      "name": "total_entries",
      "type": "integer",
      "description": "The total number of people that match your search criteria."
    },
    {
      "name": "people",
      "type": "object[]"
    }
  ],
  "outputSchema": {
    "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"
                }
              }
            }
          }
        }
      }
    }
  },
  "commands": {
    "mode": "inspect",
    "cli": "telipot inspect apollo.people.search",
    "http": "curl https://api.telipot.com/v1/tasks/apollo.people.search \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\""
  },
  "siblings": []
}