{
  "url": "https://telipot.com/catalog/capabilities/people.search",
  "id": "people.search",
  "description": "People who match title, seniority and company filters",
  "platform": "people",
  "providers": [
    {
      "slug": "apollo",
      "name": "Apollo"
    }
  ],
  "tasks": 1,
  "taskPages": [
    {
      "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": []
    }
  ]
}