{
  "id": "apollo.mixed_people.api_search",
  "object": "tool",
  "name": "Apollo People Search",
  "summary": "Find people by title, seniority, location, employer, and technology.",
  "description": "Search Apollo's database of 230M+ people to build prospect and lead lists: filter by job title, seniority, location, employer, company size, revenue, and technologies used. Returns matching people as previews (obfuscated last name, no email or phone) with the Apollo person id, which People Enrichment or Get Complete Person Info turn into a full record. Best for lead generation, recruiting, market mapping, and finding decision makers at target accounts.\n\nRaw apollo#mixed_people/api_search endpoint: input is { body, queryParams, pathParams } as the provider documents them (https://docs.apollo.io/reference/people-api-search).",
  "category": "lookup",
  "hosted_by": "Apollo",
  "runtime": "partner",
  "side_effects": false,
  "status": "live",
  "credits": 0,
  "price": "$0.0000",
  "providers": [
    {
      "id": "apollo",
      "name": "Apollo",
      "price": "$0.0000"
    }
  ],
  "mcp_name": "apollo_mixed_people_api_search",
  "input_schema": {
    "type": "object",
    "properties": {
      "queryParams": {
        "type": "object",
        "properties": {
          "person_titles[]": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Job titles to match (any one matches; similar titles are included unless include_similar_titles is false). Example: 'marketing manager'."
          },
          "include_similar_titles": {
            "type": "boolean",
            "description": "Whether titles similar to person_titles[] also match. Set false for strict title matches."
          },
          "q_keywords": {
            "type": "string",
            "minLength": 1,
            "description": "Free-text words to filter the results by."
          },
          "q_person_name": {
            "type": "string",
            "minLength": 1,
            "description": "Search by name only, independent of the other filters; a person matches when their name contains every word given."
          },
          "person_locations[]": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Where the people live: cities, US states, or countries."
          },
          "person_seniorities[]": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "owner",
                "founder",
                "c_suite",
                "partner",
                "vp",
                "head",
                "director",
                "manager",
                "senior",
                "entry",
                "intern"
              ]
            },
            "description": "Seniority of the person's CURRENT title (any one matches)."
          },
          "organization_locations[]": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Headquarters location of the person's current employer: cities, US states, or countries."
          },
          "q_organization_domains_list[]": {
            "maxItems": 1000,
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Employer domains, current or previous (no www. or @); up to 1,000."
          },
          "contact_email_status[]": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "verified",
                "unverified",
                "likely to engage",
                "unavailable"
              ]
            },
            "description": "Email statuses to include."
          },
          "organization_ids[]": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Apollo organization ids of the employers to include (from Organization Search)."
          },
          "organization_num_employees_ranges[]": {
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^\\d+,\\d+$"
            },
            "description": "Employer headcount ranges as 'lower,upper' strings, e.g. '1,10', '250,500'."
          },
          "revenue_range[min]": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Minimum revenue of the current employer, as a bare integer."
          },
          "revenue_range[max]": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Maximum revenue of the current employer, as a bare integer."
          },
          "currently_using_all_of_technology_uids[]": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Technology uids the current employer must ALL use (underscores for spaces and periods, e.g. 'google_analytics')."
          },
          "currently_using_any_of_technology_uids[]": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Technology uids of which the current employer uses at least one."
          },
          "currently_not_using_any_of_technology_uids[]": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Technology uids that exclude a person when their employer uses any."
          },
          "q_organization_job_titles[]": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Job titles listed in active job postings at the current employer."
          },
          "organization_job_locations[]": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Locations of jobs the current employer is actively recruiting for."
          },
          "organization_num_jobs_range[min]": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Minimum number of active job postings at the current employer."
          },
          "organization_num_jobs_range[max]": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Maximum number of active job postings at the current employer."
          },
          "organization_job_posted_at_range[min]": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "Earliest job-posting date at the current employer (YYYY-MM-DD)."
          },
          "organization_job_posted_at_range[max]": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "Latest job-posting date at the current employer (YYYY-MM-DD)."
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500,
            "description": "Page of results to retrieve (1-based; at most 500 pages are navigable)."
          },
          "per_page": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "Results per page (at most 100)."
          }
        },
        "additionalProperties": false
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "kind": "endpoint"
}