> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative.
> - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key.
> - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste.
> - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`.
> - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt

# Search People

> <!-- aisa-pricing:start -->
按用量计费；默认请求预估费用：$0.0243 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。
<!-- aisa-pricing:end -->

## 请求规范

* **方法与路径:** POST /apis/v1/prospeo/search-people
* **可用状态:** enabled
* **请求 URL 模板:** `https://api.aisa.one/apis/v1/prospeo/search-people`
* **Runtime 事实版本:** 14747b6d3b7c1fb8f4ed610011f8f5654aa07f8d884665f33860fa90664909fa

[完整 OpenAPI 定义](https://aisa.one/docs/reference-contracts/zh/prospeo.json)

有效请求与价格声明（包括认证和引用的 schema）：

```json theme={null}
{
  "operationId": "prospeo.search-people",
  "method": "POST",
  "path": "/apis/v1/prospeo/search-people",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "required": false,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "properties": {
            "filters": {
              "type": "object",
              "examples": [
                {
                  "company": {
                    "websites": {
                      "include": [
                        "openai.com"
                      ]
                    }
                  }
                }
              ],
              "properties": {
                "company": {
                  "type": "object",
                  "properties": {
                    "names": {
                      "type": "object",
                      "properties": {
                        "exclude": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "maxItems": 500,
                          "description": "Values to exclude, up to 500."
                        },
                        "include": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "maxItems": 500,
                          "description": "Values to include, up to 500."
                        }
                      },
                      "description": "Company names to include or exclude.",
                      "additionalProperties": false
                    },
                    "websites": {
                      "type": "object",
                      "properties": {
                        "exclude": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "maxItems": 500,
                          "description": "Values to exclude, up to 500."
                        },
                        "include": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "maxItems": 500,
                          "description": "Values to include, up to 500."
                        }
                      },
                      "description": "Root company websites or domains to include or exclude.",
                      "additionalProperties": false
                    },
                    "company_oids": {
                      "type": "object",
                      "properties": {
                        "exclude": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "maxItems": 5000,
                          "description": "Prospeo company IDs to exclude, up to 5,000."
                        },
                        "include": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "maxItems": 5000,
                          "description": "Prospeo company IDs to include, up to 5,000."
                        }
                      },
                      "description": "Prospeo company IDs to include or exclude. Valid for person search, up to 5,000 values overall.",
                      "additionalProperties": false
                    }
                  },
                  "description": "Company names, websites, or IDs. Company IDs are supported in person search.",
                  "additionalProperties": false
                },
                "company_icp": {
                  "type": "object",
                  "properties": {
                    "industries": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 10,
                      "description": "ICP industries, up to 10. GROWTH+ only."
                    },
                    "departments": {
                      "type": "object",
                      "properties": {
                        "other": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "maxItems": 5,
                          "description": "Other departments, up to 5. GROWTH+ only."
                        },
                        "include": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "Engineering",
                              "Sales",
                              "Marketing",
                              "Finance",
                              "HR",
                              "Operations",
                              "IT",
                              "Legal",
                              "Customer Success",
                              "Procurement",
                              "Data",
                              "Security",
                              "Design",
                              "SMB Owners",
                              "Consumers"
                            ],
                            "type": "string"
                          },
                          "maxItems": 15,
                          "description": "Canonical departments, up to 15. GROWTH+ only."
                        },
                        "match_mode": {
                          "enum": [
                            "any",
                            "all"
                          ],
                          "type": "string",
                          "description": "Department match mode. GROWTH+ only."
                        }
                      },
                      "description": "ICP department criteria. GROWTH+ only.",
                      "additionalProperties": false
                    },
                    "company_sizes": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "micro",
                          "smb",
                          "midmarket",
                          "enterprise",
                          "large_enterprise"
                        ],
                        "type": "string"
                      },
                      "description": "ICP company sizes. GROWTH+ only."
                    },
                    "titles_exclude": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "ICP titles to exclude, up to 20. GROWTH+ only."
                    },
                    "titles_include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "ICP titles to include, up to 20. GROWTH+ only."
                    },
                    "geographic_scope": {
                      "enum": [
                        "single_country",
                        "multi_country"
                      ],
                      "type": "string",
                      "description": "ICP geographic scope. GROWTH+ only."
                    },
                    "geographic_markets": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 10,
                      "description": "ICP geographic markets, up to 10. GROWTH+ only."
                    }
                  },
                  "description": "Ideal-customer-profile criteria. GROWTH+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "person_name": {
                  "type": "object",
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 500,
                      "description": "Names to exclude, up to 500."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 500,
                      "description": "Names to include, up to 500."
                    },
                    "person_oids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 50,
                      "description": "Prospeo person IDs, up to 50."
                    }
                  },
                  "description": "Strict person names or IDs. Mutually exclusive with person_search.",
                  "additionalProperties": false
                },
                "company_news": {
                  "type": "object",
                  "properties": {
                    "keywords": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "News keywords, up to 20."
                    },
                    "categories": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "Funding & Investment",
                          "Mergers & Acquisitions",
                          "Product Launch",
                          "Partnership",
                          "Expansion",
                          "Layoffs & Restructuring",
                          "IPO",
                          "Leadership Change",
                          "Legal & Regulatory",
                          "Awards & Recognition"
                        ],
                        "type": "string"
                      },
                      "maxItems": 10,
                      "description": "News categories, up to 10."
                    },
                    "timeframe_days": {
                      "enum": [
                        60,
                        90,
                        180,
                        365
                      ],
                      "type": "integer",
                      "description": "News lookback window in days."
                    }
                  },
                  "description": "Company-news criteria.",
                  "additionalProperties": false
                },
                "company_sics": {
                  "type": "object",
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "maxItems": 100,
                      "description": "Codes to exclude, up to 100."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "maxItems": 100,
                      "description": "Codes to include, up to 100."
                    }
                  },
                  "description": "SIC codes resolved through SEARCH_SUGGESTIONS.",
                  "additionalProperties": false
                },
                "company_type": {
                  "anyOf": [
                    {
                      "type": "object",
                      "title": "CompanyTypeDetails",
                      "properties": {
                        "status": {
                          "anyOf": [
                            {
                              "enum": [
                                "Private",
                                "Public",
                                "Non Profit",
                                "Other"
                              ],
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Status",
                          "default": null,
                          "description": "Company ownership status."
                        },
                        "subtypes": {
                          "anyOf": [
                            {
                              "type": "object",
                              "title": "CompanySubtypeFilter",
                              "properties": {
                                "exclude": {
                                  "anyOf": [
                                    {
                                      "type": "array",
                                      "items": {
                                        "enum": [
                                          "SaaS",
                                          "Marketplace",
                                          "E-commerce",
                                          "Agency",
                                          "Consulting",
                                          "Manufacturing",
                                          "Media/Publisher",
                                          "Education",
                                          "Non-Profit",
                                          "Government",
                                          "FinTech",
                                          "HealthTech",
                                          "AI/ML",
                                          "Hardware",
                                          "Professional Services",
                                          "Platform",
                                          "Data/Analytics",
                                          "Franchise",
                                          "Logistics",
                                          "Real Estate",
                                          "Legal",
                                          "Insurance",
                                          "Retail",
                                          "Hospitality",
                                          "Food & Beverage",
                                          "Construction",
                                          "Telecommunications"
                                        ],
                                        "type": "string"
                                      }
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "title": "Exclude",
                                  "default": null,
                                  "description": "Company subtypes to exclude."
                                },
                                "include": {
                                  "anyOf": [
                                    {
                                      "type": "array",
                                      "items": {
                                        "enum": [
                                          "SaaS",
                                          "Marketplace",
                                          "E-commerce",
                                          "Agency",
                                          "Consulting",
                                          "Manufacturing",
                                          "Media/Publisher",
                                          "Education",
                                          "Non-Profit",
                                          "Government",
                                          "FinTech",
                                          "HealthTech",
                                          "AI/ML",
                                          "Hardware",
                                          "Professional Services",
                                          "Platform",
                                          "Data/Analytics",
                                          "Franchise",
                                          "Logistics",
                                          "Real Estate",
                                          "Legal",
                                          "Insurance",
                                          "Retail",
                                          "Hospitality",
                                          "Food & Beverage",
                                          "Construction",
                                          "Telecommunications"
                                        ],
                                        "type": "string"
                                      }
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "title": "Include",
                                  "default": null,
                                  "description": "Company subtypes to include."
                                }
                              }
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "default": null,
                          "description": "Company subtypes to include or exclude."
                        },
                        "is_retail": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Is Retail",
                          "default": null,
                          "description": "Filter retail companies."
                        },
                        "is_mainly_ai": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Is Mainly Ai",
                          "default": null,
                          "description": "Filter primarily AI companies."
                        },
                        "is_sales_led": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Is Sales Led",
                          "default": null,
                          "description": "Filter sales-led companies."
                        },
                        "has_free_tier": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Has Free Tier",
                          "default": null,
                          "description": "Filter by free-tier availability."
                        },
                        "is_self_serve": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Is Self Serve",
                          "default": null,
                          "description": "Filter self-serve companies."
                        },
                        "multi_product": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Multi Product",
                          "default": null,
                          "description": "Filter multi-product companies."
                        },
                        "business_model": {
                          "anyOf": [
                            {
                              "enum": [
                                "b2b",
                                "b2c",
                                "b2b2c",
                                "d2c",
                                "marketplace",
                                "franchise",
                                "non_profit",
                                "government"
                              ],
                              "type": "string"
                            },
                            {
                              "type": "array",
                              "items": {
                                "enum": [
                                  "b2b",
                                  "b2c",
                                  "b2b2c",
                                  "d2c",
                                  "marketplace",
                                  "franchise",
                                  "non_profit",
                                  "government"
                                ],
                                "type": "string"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Business Model",
                          "default": null,
                          "description": "Business model or models."
                        },
                        "is_marketplace": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Is Marketplace",
                          "default": null,
                          "description": "Filter marketplace companies."
                        },
                        "has_subscription": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Has Subscription",
                          "default": null,
                          "description": "Filter by subscription offering."
                        },
                        "is_mainly_crypto": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Is Mainly Crypto",
                          "default": null,
                          "description": "Filter primarily crypto companies."
                        },
                        "has_usage_pricing": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Has Usage Pricing",
                          "default": null,
                          "description": "Filter by usage-based pricing."
                        },
                        "has_public_pricing": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Has Public Pricing",
                          "default": null,
                          "description": "Filter by public pricing."
                        },
                        "has_enterprise_plan": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Has Enterprise Plan",
                          "default": null,
                          "description": "Filter by enterprise-plan availability."
                        }
                      }
                    },
                    {
                      "enum": [
                        "Private",
                        "Public",
                        "Non Profit",
                        "Other"
                      ],
                      "type": "string"
                    }
                  ],
                  "description": "Company ownership status or detailed company-type facets. Available on FREE."
                },
                "company_naics": {
                  "type": "object",
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "maxItems": 100,
                      "description": "Codes to exclude, up to 100."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "maxItems": 100,
                      "description": "Codes to include, up to 100."
                    }
                  },
                  "description": "NAICS codes resolved through SEARCH_SUGGESTIONS.",
                  "additionalProperties": false
                },
                "person_search": {
                  "type": "object",
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 500,
                      "description": "Broad person terms to exclude, up to 500; each 1-100 characters."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 500,
                      "description": "Broad person terms to include, up to 500; each 1-100 characters."
                    },
                    "match_mode": {
                      "enum": [
                        "SMART",
                        "STRICT"
                      ],
                      "type": "string",
                      "description": "Broad person-term match mode."
                    }
                  },
                  "description": "Broad person terms. Mutually exclusive with person_name.",
                  "additionalProperties": false
                },
                "company_awards": {
                  "type": "object",
                  "required": [
                    "include"
                  ],
                  "properties": {
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 50,
                      "minItems": 1,
                      "description": "Awards to include, 1-50. GROWTH+ only."
                    },
                    "match_mode": {
                      "enum": [
                        "EXACT",
                        "CONTAINS"
                      ],
                      "type": "string",
                      "description": "Award match mode. GROWTH+ only."
                    }
                  },
                  "description": "Company awards. GROWTH+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "company_intent": {
                  "type": "object",
                  "required": [
                    "topic_ids"
                  ],
                  "properties": {
                    "topic_ids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 30,
                      "minItems": 1,
                      "description": "Account-specific dashboard topic IDs, 1-30; this API cannot discover them."
                    },
                    "early_research": {
                      "type": "boolean",
                      "description": "Require early research intent."
                    },
                    "active_research": {
                      "type": "boolean",
                      "description": "Require active research intent."
                    },
                    "in_depth_research": {
                      "type": "boolean",
                      "description": "Require in-depth research intent."
                    }
                  },
                  "description": "Intent topics from the Prospeo dashboard; topic IDs cannot be discovered through this API.",
                  "additionalProperties": false
                },
                "company_founded": {
                  "type": "object",
                  "properties": {
                    "max": {
                      "type": "integer",
                      "minimum": 1900,
                      "description": "Latest founding year."
                    },
                    "min": {
                      "type": "integer",
                      "minimum": 1900,
                      "description": "Earliest founding year."
                    },
                    "include_unknown_founded": {
                      "type": "boolean",
                      "description": "Include companies with unknown founding year."
                    }
                  },
                  "description": "Founding-year range.",
                  "additionalProperties": false
                },
                "company_funding": {
                  "type": "object",
                  "properties": {
                    "stage": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "Angel",
                          "Convertible note",
                          "Corporate round",
                          "Debt financing",
                          "Equity crowdfunding",
                          "Grant",
                          "Initial coin offering",
                          "Non equity assistance",
                          "Post IPO debt",
                          "Post IPO equity",
                          "Post IPO secondary",
                          "Pre seed",
                          "Private equity",
                          "Product crowdfunding",
                          "Secondary market",
                          "Seed",
                          "Series A",
                          "Series B",
                          "Series C",
                          "Series D",
                          "Series E-J",
                          "Series unknown",
                          "Undisclosed"
                        ],
                        "type": "string"
                      },
                      "maxItems": 500,
                      "description": "Funding stages, up to 500. STARTER+ only."
                    },
                    "investors": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 10,
                      "description": "Investors, up to 10. STARTER+ only."
                    },
                    "funding_date": {
                      "enum": [
                        30,
                        60,
                        90,
                        180,
                        270,
                        365
                      ],
                      "type": "integer",
                      "description": "Days since funding. STARTER+ only."
                    },
                    "last_funding": {
                      "type": "object",
                      "properties": {
                        "max": {
                          "enum": [
                            "<100K",
                            "100K",
                            "500K",
                            "1M",
                            "5M",
                            "10M",
                            "25M",
                            "50M",
                            "100M",
                            "250M",
                            "500M",
                            "1B",
                            "5B",
                            "10B+"
                          ],
                          "type": "string",
                          "description": "Inclusive maximum revenue band."
                        },
                        "min": {
                          "enum": [
                            "<100K",
                            "100K",
                            "500K",
                            "1M",
                            "5M",
                            "10M",
                            "25M",
                            "50M",
                            "100M",
                            "250M",
                            "500M",
                            "1B",
                            "5B",
                            "10B+"
                          ],
                          "type": "string",
                          "description": "Inclusive minimum revenue band."
                        }
                      },
                      "description": "Latest funding amount range. STARTER+ only.",
                      "additionalProperties": false
                    },
                    "total_funding": {
                      "type": "object",
                      "properties": {
                        "max": {
                          "enum": [
                            "<100K",
                            "100K",
                            "500K",
                            "1M",
                            "5M",
                            "10M",
                            "25M",
                            "50M",
                            "100M",
                            "250M",
                            "500M",
                            "1B",
                            "5B",
                            "10B+"
                          ],
                          "type": "string",
                          "description": "Inclusive maximum revenue band."
                        },
                        "min": {
                          "enum": [
                            "<100K",
                            "100K",
                            "500K",
                            "1M",
                            "5M",
                            "10M",
                            "25M",
                            "50M",
                            "100M",
                            "250M",
                            "500M",
                            "1B",
                            "5B",
                            "10B+"
                          ],
                          "type": "string",
                          "description": "Inclusive minimum revenue band."
                        }
                      },
                      "description": "Total funding amount range. STARTER+ only.",
                      "additionalProperties": false
                    },
                    "accelerator_name": {
                      "type": "string",
                      "description": "Accelerator name. STARTER+ only."
                    },
                    "was_in_accelerator": {
                      "type": "boolean",
                      "description": "Filter accelerator participation. STARTER+ only."
                    }
                  },
                  "description": "Funding criteria. STARTER+ only; FREE returns PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "company_revenue": {
                  "type": "object",
                  "properties": {
                    "max": {
                      "enum": [
                        "<100K",
                        "100K",
                        "500K",
                        "1M",
                        "5M",
                        "10M",
                        "25M",
                        "50M",
                        "100M",
                        "250M",
                        "500M",
                        "1B",
                        "5B",
                        "10B+"
                      ],
                      "type": "string",
                      "description": "Maximum revenue bucket. STARTER+ only."
                    },
                    "min": {
                      "enum": [
                        "<100K",
                        "100K",
                        "500K",
                        "1M",
                        "5M",
                        "10M",
                        "25M",
                        "50M",
                        "100M",
                        "250M",
                        "500M",
                        "1B",
                        "5B",
                        "10B+"
                      ],
                      "type": "string",
                      "description": "Minimum revenue bucket. STARTER+ only."
                    },
                    "include_unknown_revenue": {
                      "type": "boolean",
                      "description": "Include companies with unknown revenue. STARTER+ only."
                    }
                  },
                  "description": "Revenue criteria. STARTER+ only; FREE returns PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "company_industry": {
                  "type": "object",
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 500,
                      "description": "Values to exclude, up to 500."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 500,
                      "description": "Values to include, up to 500."
                    }
                  },
                  "description": "Canonical company industries.",
                  "additionalProperties": false
                },
                "company_keywords": {
                  "type": "object",
                  "required": [
                    "include"
                  ],
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "Keywords to exclude, up to 20."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "minItems": 1,
                      "description": "Keywords to include; 1-20 are required."
                    },
                    "sources": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "specialties",
                          "social_media_description",
                          "seo_description",
                          "ai_description",
                          "products_services",
                          "website_pages"
                        ],
                        "type": "string"
                      },
                      "description": "Company text sources to search."
                    },
                    "include_all": {
                      "type": "boolean",
                      "description": "Require all included keywords instead of any keyword."
                    },
                    "search_everywhere": {
                      "type": "boolean",
                      "description": "Search all supported company text sources."
                    }
                  },
                  "description": "Company keyword criteria.",
                  "additionalProperties": false
                },
                "person_education": {
                  "type": "object",
                  "properties": {
                    "degrees": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "high school",
                          "associate",
                          "bachelors",
                          "masters",
                          "mba",
                          "phd",
                          "professional",
                          "diploma",
                          "vocational",
                          "other"
                        ],
                        "type": "string"
                      },
                      "description": "Degree levels. GROWTH+ only."
                    },
                    "schools": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "Schools, up to 20. GROWTH+ only."
                    },
                    "graduated_max": {
                      "type": "integer",
                      "minimum": 1950,
                      "description": "Latest graduation year. GROWTH+ only."
                    },
                    "graduated_min": {
                      "type": "integer",
                      "minimum": 1950,
                      "description": "Earliest graduation year. GROWTH+ only."
                    },
                    "fields_of_study": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "Fields of study, up to 20. GROWTH+ only."
                    }
                  },
                  "description": "Education criteria. GROWTH+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "person_job_title": {
                  "type": "object",
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 100,
                      "description": "Current job titles to exclude, up to 100."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 100,
                      "description": "Current job titles to include, up to 100."
                    },
                    "match_mode": {
                      "enum": [
                        "CONTAINS",
                        "EXACT",
                        "SIMILAR"
                      ],
                      "type": "string",
                      "description": "Job-title match mode."
                    },
                    "boolean_search": {
                      "type": "string",
                      "description": "Boolean current-title query; cannot combine with include or exclude."
                    },
                    "smart_intensity": {
                      "enum": [
                        "LOOSE",
                        "NORMAL",
                        "STRICT"
                      ],
                      "type": "string",
                      "description": "Similarity intensity for smart title matching."
                    }
                  },
                  "description": "Current job-title criteria.",
                  "additionalProperties": false
                },
                "person_seniority": {
                  "type": "object",
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "C-Suite",
                          "Director",
                          "Entry",
                          "Founder/Owner",
                          "Head",
                          "Intern",
                          "Manager",
                          "Partner",
                          "Senior",
                          "Vice President"
                        ],
                        "type": "string"
                      },
                      "maxItems": 11,
                      "description": "Canonical seniorities to exclude, up to 11."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "C-Suite",
                          "Director",
                          "Entry",
                          "Founder/Owner",
                          "Head",
                          "Intern",
                          "Manager",
                          "Partner",
                          "Senior",
                          "Vice President"
                        ],
                        "type": "string"
                      },
                      "maxItems": 11,
                      "description": "Canonical seniorities to include, up to 11."
                    }
                  },
                  "description": "Canonical seniorities, at most 11; include and exclude are mutually exclusive.",
                  "additionalProperties": false
                },
                "company_key_execs": {
                  "type": "object",
                  "required": [
                    "event_types"
                  ],
                  "properties": {
                    "event_types": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "CEO Departed",
                          "CEO Appointed",
                          "CTO Departed",
                          "CTO Appointed",
                          "CFO Departed",
                          "CFO Appointed",
                          "COO Departed",
                          "COO Appointed",
                          "CMO Departed",
                          "CMO Appointed",
                          "CRO Departed",
                          "CRO Appointed",
                          "VP of Sales Departed",
                          "VP of Sales Appointed",
                          "VP of Marketing Departed",
                          "VP of Marketing Appointed",
                          "VP of Engineering Departed",
                          "VP of Engineering Appointed",
                          "Any C-Level Departed",
                          "Any C-Level Appointed",
                          "Any VP Departed",
                          "Any VP Appointed",
                          "Any Director Departed",
                          "Any Director Appointed"
                        ],
                        "type": "string"
                      },
                      "maxItems": 10,
                      "minItems": 1,
                      "description": "Executive event types, 1-10. PRO+ only."
                    },
                    "timeframe_days": {
                      "enum": [
                        60,
                        90,
                        180,
                        365
                      ],
                      "type": "integer",
                      "description": "Executive-event lookback in days. PRO+ only."
                    }
                  },
                  "description": "Key-executive events. PRO+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "company_lookalike": {
                  "type": "object",
                  "properties": {
                    "domain": {
                      "type": "string",
                      "description": "Seed company domain. STARTER+ only."
                    },
                    "icp_text": {
                      "type": "string",
                      "maxLength": 5000,
                      "description": "Ideal-customer description, up to 5,000 characters. STARTER+ only."
                    },
                    "match_all": {
                      "type": "boolean",
                      "description": "Require all lookalike dimensions. STARTER+ only."
                    },
                    "person_oids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 10,
                      "description": "Seed person IDs, up to 10; valid for person search. STARTER+ only."
                    },
                    "company_oids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 10,
                      "description": "Seed company IDs, up to 10. STARTER+ only."
                    },
                    "minimum_tier": {
                      "enum": [
                        "T1",
                        "T2",
                        "T3"
                      ],
                      "type": "string",
                      "description": "Minimum match tier. STARTER+ only."
                    },
                    "same_language": {
                      "type": "boolean",
                      "description": "Require the same language. STARTER+ only."
                    }
                  },
                  "description": "Exactly one lookalike seed mode. STARTER+ only; person_oids are valid in this person search.",
                  "additionalProperties": false
                },
                "person_department": {
                  "type": "object",
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "C-Suite",
                          "Chief Executive",
                          "Finance Executive",
                          "Founder",
                          "Human Resources Executive",
                          "Information Technology Executive",
                          "Legal Executive",
                          "Marketing Executive",
                          "Medical & Health Executive",
                          "Operations Executive",
                          "Sales Leader",
                          "Product",
                          "Product Development",
                          "Product Management",
                          "Other Product",
                          "Engineering & Technical",
                          "Artificial Intelligence / Machine Learning",
                          "Bioengineering",
                          "Biometrics",
                          "Business Intelligence",
                          "Chemical Engineering",
                          "Data Science & Analysis",
                          "DevOps",
                          "Digital Transformation",
                          "Emerging Technology / Innovation",
                          "Industrial Engineering",
                          "Mechanic",
                          "Mobile Development",
                          "Project Management",
                          "Research & Development",
                          "Scrum Master / Agile Coach",
                          "Software Development",
                          "Technician",
                          "Technology Operations",
                          "Test / Quality Assurance",
                          "Consulting",
                          "Consultant",
                          "Design",
                          "Other Design",
                          "Graphic / Visual / Brand Design",
                          "Education & Coaching",
                          "Teacher",
                          "Superintendent",
                          "Professor",
                          "Coach / Trainer",
                          "Finance",
                          "Financial Reporting",
                          "Financial Systems",
                          "Accounting",
                          "Finance & Banking",
                          "Financial Planning, Strategy & Analysis",
                          "Internal Audit & Control",
                          "Investor Relations",
                          "Mergers & Acquisitions",
                          "Real Estate Finance",
                          "Financial Risk",
                          "Sourcing / Procurement",
                          "Tax",
                          "Treasury",
                          "Human Resources",
                          "Compensation & Benefits",
                          "Culture, Diversity & Inclusion",
                          "Health & Safety",
                          "Other Human Resources",
                          "HR Business Partner",
                          "Learning & Development",
                          "Organizational Development",
                          "Recruiting & Talent Acquisition",
                          "Talent Management",
                          "Workforce Management",
                          "People Operations",
                          "Information Technology",
                          "Cloud Engineering",
                          "Data Center",
                          "Data Warehouse",
                          "Database Administration",
                          "eCommerce Development",
                          "Help Desk / Desktop Services",
                          "Information Security",
                          "IT Asset Management",
                          "IT Audit / IT Compliance",
                          "IT Recruitement",
                          "IT Procurement",
                          "IT Strategy",
                          "IT Training",
                          "Networking",
                          "Technical Lead",
                          "Quality Assurance",
                          "Retail / Store Systems",
                          "Servers",
                          "Disaster Recovery",
                          "Telecommunications",
                          "Legal",
                          "Compliance",
                          "Contracts",
                          "Corporate Secretary",
                          "eDiscovery",
                          "Ethics",
                          "Governance",
                          "Governmental Affairs & Regulatory Law",
                          "Intellectual Property & Patent",
                          "Labor & Employment",
                          "Lawyer / Attorney",
                          "Other Legal",
                          "Legal Counsel",
                          "Legal Operations",
                          "Litigation",
                          "Privacy",
                          "Marketing",
                          "Advertising",
                          "Brand Management",
                          "Content Marketing",
                          "Customer Experience",
                          "Customer Marketing",
                          "Growth & Demand Generation",
                          "Digital Marketing",
                          "eCommerce Marketing",
                          "Event & Field Marketing",
                          "Lead Generation",
                          "Marketing Operations",
                          "Product Marketing",
                          "Public Relations",
                          "SEO",
                          "Social Media Marketing",
                          "Technical Marketing",
                          "Medical & Health",
                          "Anesthesiology",
                          "Chiropractics",
                          "Clinical Systems",
                          "Dentistry",
                          "Dermatology",
                          "Doctors / Physicians",
                          "Epidemiology",
                          "Fire Responder",
                          "Infectious Disease",
                          "Medical Administration",
                          "Medical Education & Training",
                          "Clinical Research",
                          "Neurology",
                          "Nursing",
                          "Nutrition & Dietetics",
                          "Obstetrics / Gynecology",
                          "Oncology",
                          "Opthalmology",
                          "Optometry",
                          "Orthopedics",
                          "Radiology",
                          "Public Health",
                          "Psychology",
                          "Psychiatry",
                          "Physical Therapy",
                          "Pharmacy",
                          "Pediatrics",
                          "Pathology",
                          "Operations",
                          "Supply Chain",
                          "Store Operations",
                          "Safety",
                          "Real Estate",
                          "Quality Management",
                          "Physical Security",
                          "Office Operations",
                          "Logistics",
                          "Leasing",
                          "Facilities Management",
                          "Customer Service / Support",
                          "Corporate Strategy",
                          "Construction",
                          "Call Center",
                          "Sales",
                          "Other Sales",
                          "Sales Training",
                          "Sales Operations",
                          "Sales Engineering",
                          "Sales Enablement",
                          "Revenue Operations",
                          "Partnerships",
                          "Sales Development",
                          "Account Executive",
                          "Field / Outside Sales",
                          "Customer Success",
                          "Customer Retention & Development",
                          "Channel Sales",
                          "Account Management"
                        ],
                        "type": "string"
                      },
                      "maxItems": 100,
                      "description": "Canonical values to exclude."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "C-Suite",
                          "Chief Executive",
                          "Finance Executive",
                          "Founder",
                          "Human Resources Executive",
                          "Information Technology Executive",
                          "Legal Executive",
                          "Marketing Executive",
                          "Medical & Health Executive",
                          "Operations Executive",
                          "Sales Leader",
                          "Product",
                          "Product Development",
                          "Product Management",
                          "Other Product",
                          "Engineering & Technical",
                          "Artificial Intelligence / Machine Learning",
                          "Bioengineering",
                          "Biometrics",
                          "Business Intelligence",
                          "Chemical Engineering",
                          "Data Science & Analysis",
                          "DevOps",
                          "Digital Transformation",
                          "Emerging Technology / Innovation",
                          "Industrial Engineering",
                          "Mechanic",
                          "Mobile Development",
                          "Project Management",
                          "Research & Development",
                          "Scrum Master / Agile Coach",
                          "Software Development",
                          "Technician",
                          "Technology Operations",
                          "Test / Quality Assurance",
                          "Consulting",
                          "Consultant",
                          "Design",
                          "Other Design",
                          "Graphic / Visual / Brand Design",
                          "Education & Coaching",
                          "Teacher",
                          "Superintendent",
                          "Professor",
                          "Coach / Trainer",
                          "Finance",
                          "Financial Reporting",
                          "Financial Systems",
                          "Accounting",
                          "Finance & Banking",
                          "Financial Planning, Strategy & Analysis",
                          "Internal Audit & Control",
                          "Investor Relations",
                          "Mergers & Acquisitions",
                          "Real Estate Finance",
                          "Financial Risk",
                          "Sourcing / Procurement",
                          "Tax",
                          "Treasury",
                          "Human Resources",
                          "Compensation & Benefits",
                          "Culture, Diversity & Inclusion",
                          "Health & Safety",
                          "Other Human Resources",
                          "HR Business Partner",
                          "Learning & Development",
                          "Organizational Development",
                          "Recruiting & Talent Acquisition",
                          "Talent Management",
                          "Workforce Management",
                          "People Operations",
                          "Information Technology",
                          "Cloud Engineering",
                          "Data Center",
                          "Data Warehouse",
                          "Database Administration",
                          "eCommerce Development",
                          "Help Desk / Desktop Services",
                          "Information Security",
                          "IT Asset Management",
                          "IT Audit / IT Compliance",
                          "IT Recruitement",
                          "IT Procurement",
                          "IT Strategy",
                          "IT Training",
                          "Networking",
                          "Technical Lead",
                          "Quality Assurance",
                          "Retail / Store Systems",
                          "Servers",
                          "Disaster Recovery",
                          "Telecommunications",
                          "Legal",
                          "Compliance",
                          "Contracts",
                          "Corporate Secretary",
                          "eDiscovery",
                          "Ethics",
                          "Governance",
                          "Governmental Affairs & Regulatory Law",
                          "Intellectual Property & Patent",
                          "Labor & Employment",
                          "Lawyer / Attorney",
                          "Other Legal",
                          "Legal Counsel",
                          "Legal Operations",
                          "Litigation",
                          "Privacy",
                          "Marketing",
                          "Advertising",
                          "Brand Management",
                          "Content Marketing",
                          "Customer Experience",
                          "Customer Marketing",
                          "Growth & Demand Generation",
                          "Digital Marketing",
                          "eCommerce Marketing",
                          "Event & Field Marketing",
                          "Lead Generation",
                          "Marketing Operations",
                          "Product Marketing",
                          "Public Relations",
                          "SEO",
                          "Social Media Marketing",
                          "Technical Marketing",
                          "Medical & Health",
                          "Anesthesiology",
                          "Chiropractics",
                          "Clinical Systems",
                          "Dentistry",
                          "Dermatology",
                          "Doctors / Physicians",
                          "Epidemiology",
                          "Fire Responder",
                          "Infectious Disease",
                          "Medical Administration",
                          "Medical Education & Training",
                          "Clinical Research",
                          "Neurology",
                          "Nursing",
                          "Nutrition & Dietetics",
                          "Obstetrics / Gynecology",
                          "Oncology",
                          "Opthalmology",
                          "Optometry",
                          "Orthopedics",
                          "Radiology",
                          "Public Health",
                          "Psychology",
                          "Psychiatry",
                          "Physical Therapy",
                          "Pharmacy",
                          "Pediatrics",
                          "Pathology",
                          "Operations",
                          "Supply Chain",
                          "Store Operations",
                          "Safety",
                          "Real Estate",
                          "Quality Management",
                          "Physical Security",
                          "Office Operations",
                          "Logistics",
                          "Leasing",
                          "Facilities Management",
                          "Customer Service / Support",
                          "Corporate Strategy",
                          "Construction",
                          "Call Center",
                          "Sales",
                          "Other Sales",
                          "Sales Training",
                          "Sales Operations",
                          "Sales Engineering",
                          "Sales Enablement",
                          "Revenue Operations",
                          "Partnerships",
                          "Sales Development",
                          "Account Executive",
                          "Field / Outside Sales",
                          "Customer Success",
                          "Customer Retention & Development",
                          "Channel Sales",
                          "Account Management"
                        ],
                        "type": "string"
                      },
                      "maxItems": 100,
                      "description": "Canonical values to include."
                    }
                  },
                  "description": "Canonical departments; include and exclude are mutually exclusive.",
                  "additionalProperties": false
                },
                "person_job_change": {
                  "type": "object",
                  "properties": {
                    "only_promotion": {
                      "type": "boolean",
                      "description": "Return promotions only. GROWTH+ only."
                    },
                    "timeframe_days": {
                      "enum": [
                        30,
                        60,
                        90,
                        180,
                        270,
                        365
                      ],
                      "type": "integer",
                      "description": "Job-change lookback in days. GROWTH+ only."
                    },
                    "only_new_company": {
                      "type": "boolean",
                      "description": "Return moves to a new company only. GROWTH+ only."
                    }
                  },
                  "description": "Recent job-change criteria. GROWTH+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "company_attributes": {
                  "type": "object",
                  "properties": {
                    "b2b": {
                      "type": "boolean",
                      "description": "Filter by B2B status."
                    },
                    "demo": {
                      "type": "boolean",
                      "description": "Filter by demo availability."
                    },
                    "has_api": {
                      "type": "boolean",
                      "description": "Filter by API availability."
                    },
                    "has_sso": {
                      "type": "boolean",
                      "description": "Filter by SSO availability."
                    },
                    "pricing": {
                      "type": "boolean",
                      "description": "Filter by public-pricing presence."
                    },
                    "uses_ai": {
                      "type": "boolean",
                      "description": "Filter by use of AI."
                    },
                    "has_blog": {
                      "type": "boolean",
                      "description": "Filter by blog presence."
                    },
                    "has_ccpa": {
                      "type": "boolean",
                      "description": "Filter by CCPA compliance."
                    },
                    "has_gdpr": {
                      "type": "boolean",
                      "description": "Filter by GDPR compliance."
                    },
                    "has_soc2": {
                      "type": "boolean",
                      "description": "Filter by SOC 2 compliance."
                    },
                    "freetrial": {
                      "type": "boolean",
                      "description": "Filter by free-trial availability."
                    },
                    "has_hipaa": {
                      "type": "boolean",
                      "description": "Filter by HIPAA compliance."
                    },
                    "mobileapps": {
                      "type": "boolean",
                      "description": "Filter by mobile-app availability."
                    },
                    "has_academy": {
                      "type": "boolean",
                      "description": "Filter by academy presence."
                    },
                    "has_pci_dss": {
                      "type": "boolean",
                      "description": "Filter by PCI DSS compliance."
                    },
                    "has_podcast": {
                      "type": "boolean",
                      "description": "Filter by podcast presence."
                    },
                    "downloadable": {
                      "type": "boolean",
                      "description": "Filter by downloadable products."
                    },
                    "has_iso27001": {
                      "type": "boolean",
                      "description": "Filter by ISO 27001 compliance."
                    },
                    "onlinereviews": {
                      "type": "boolean",
                      "description": "Filter by online-review presence."
                    },
                    "data_residency": {
                      "type": "string",
                      "description": "Required data-residency location."
                    },
                    "has_esg_reports": {
                      "type": "boolean",
                      "description": "Filter by ESG-report availability."
                    },
                    "has_marketplace": {
                      "type": "boolean",
                      "description": "Filter by marketplace presence."
                    },
                    "has_open_source": {
                      "type": "boolean",
                      "description": "Filter by open-source offering."
                    },
                    "has_case_studies": {
                      "type": "boolean",
                      "description": "Filter by case-study presence."
                    },
                    "has_chat_support": {
                      "type": "boolean",
                      "description": "Filter by chat support."
                    },
                    "has_testimonials": {
                      "type": "boolean",
                      "description": "Filter by testimonial presence."
                    },
                    "other_compliance": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 50,
                      "description": "Other compliance standards, up to 50."
                    },
                    "has_email_support": {
                      "type": "boolean",
                      "description": "Filter by email support."
                    },
                    "has_phone_support": {
                      "type": "boolean",
                      "description": "Filter by phone support."
                    },
                    "is_venture_backed": {
                      "type": "boolean",
                      "description": "Filter by venture-backed status."
                    },
                    "has_knowledge_base": {
                      "type": "boolean",
                      "description": "Filter by knowledge-base presence."
                    },
                    "has_social_support": {
                      "type": "boolean",
                      "description": "Filter by social-media support."
                    },
                    "has_ticket_support": {
                      "type": "boolean",
                      "description": "Filter by ticket support."
                    },
                    "is_publicly_traded": {
                      "type": "boolean",
                      "description": "Filter by public-company status."
                    },
                    "has_community_forum": {
                      "type": "boolean",
                      "description": "Filter by community forum presence."
                    },
                    "has_chrome_extension": {
                      "type": "boolean",
                      "description": "Filter by Chrome extension availability."
                    },
                    "has_physical_offices": {
                      "type": "boolean",
                      "description": "Filter by physical-office presence."
                    },
                    "has_uptime_guarantee": {
                      "type": "boolean",
                      "description": "Filter by uptime guarantee."
                    },
                    "compliance_match_mode": {
                      "enum": [
                        "EXACT",
                        "CONTAINS"
                      ],
                      "type": "string",
                      "description": "How other compliance values are matched."
                    },
                    "has_affiliate_program": {
                      "type": "boolean",
                      "description": "Filter by affiliate-program presence."
                    }
                  },
                  "description": "Explicit company product, support, compliance, and status attributes.",
                  "additionalProperties": false
                },
                "company_technology": {
                  "type": "object",
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "Values to exclude, up to 20."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "Values to include, up to 20."
                    }
                  },
                  "description": "Canonical technologies, up to 20 per list. STARTER+ only; FREE was verified to return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "person_past_company": {
                  "type": "object",
                  "required": [
                    "company_oids"
                  ],
                  "properties": {
                    "company_oids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 100,
                      "minItems": 1,
                      "description": "Past Prospeo company IDs, 1-100. GROWTH+ only."
                    },
                    "combine_with_current": {
                      "enum": [
                        "OR",
                        "AND"
                      ],
                      "type": "string",
                      "description": "How past and current companies combine. GROWTH+ only."
                    }
                  },
                  "description": "Past company criteria. GROWTH+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "company_integrations": {
                  "type": "object",
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 10,
                      "description": "Integrations to exclude, up to 10; requires include. GROWTH+ only."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "Integrations to include, up to 20. GROWTH+ only."
                    }
                  },
                  "description": "Integration criteria. GROWTH+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "company_key_customers": {
                  "type": "object",
                  "required": [
                    "include"
                  ],
                  "properties": {
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 100,
                      "minItems": 1,
                      "description": "Required values, 1-100."
                    }
                  },
                  "description": "Key customer names. GROWTH+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "person_past_job_title": {
                  "type": "object",
                  "required": [
                    "include"
                  ],
                  "properties": {
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 50,
                      "minItems": 1,
                      "description": "Past job titles, 1-50. GROWTH+ only."
                    },
                    "match_mode": {
                      "enum": [
                        "EXACT",
                        "CONTAINS"
                      ],
                      "type": "string",
                      "description": "Past-title match mode. GROWTH+ only."
                    },
                    "titles_logic": {
                      "enum": [
                        "OR",
                        "AND"
                      ],
                      "type": "string",
                      "description": "How past titles combine. GROWTH+ only."
                    },
                    "combine_with_current": {
                      "enum": [
                        "OR",
                        "AND"
                      ],
                      "type": "string",
                      "description": "How past and current titles combine. GROWTH+ only."
                    }
                  },
                  "description": "Past title criteria. GROWTH+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "company_email_provider": {
                  "type": "array",
                  "items": {
                    "enum": [
                      "Microsoft",
                      "Google",
                      "Proofpoint",
                      "Mimecast",
                      "Other"
                    ],
                    "type": "string"
                  },
                  "description": "Company email infrastructure providers."
                },
                "company_website_search": {
                  "type": "object",
                  "properties": {
                    "search_in": {
                      "type": "object",
                      "properties": {
                        "page_body": {
                          "type": "boolean",
                          "description": "Search page body text. PRO+ only."
                        },
                        "urls_only": {
                          "type": "boolean",
                          "description": "Search URLs only. PRO+ only."
                        },
                        "page_titles": {
                          "type": "boolean",
                          "description": "Search page titles. PRO+ only."
                        },
                        "headings_only": {
                          "type": "boolean",
                          "description": "Search headings only. PRO+ only."
                        },
                        "seo_description": {
                          "type": "boolean",
                          "description": "Search SEO descriptions. PRO+ only."
                        }
                      },
                      "description": "Website areas to search. PRO+ only.",
                      "additionalProperties": false
                    },
                    "match_mode": {
                      "enum": [
                        "any",
                        "all"
                      ],
                      "type": "string",
                      "description": "Website keyword match mode. PRO+ only."
                    },
                    "page_scope": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "homepage",
                          "product",
                          "blog",
                          "careers",
                          "about"
                        ],
                        "type": "string"
                      },
                      "maxItems": 5,
                      "description": "Page scopes, up to 5. PRO+ only."
                    },
                    "has_sla_page": {
                      "type": "boolean",
                      "description": "Filter by SLA page. PRO+ only."
                    },
                    "url_contains": {
                      "type": "string",
                      "description": "Required URL substring. PRO+ only."
                    },
                    "has_status_page": {
                      "type": "boolean",
                      "description": "Filter by status page. PRO+ only."
                    },
                    "exclude_keywords": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 10,
                      "description": "Website keywords to exclude, up to 10. PRO+ only."
                    },
                    "has_careers_page": {
                      "type": "boolean",
                      "description": "Filter by careers page. PRO+ only."
                    },
                    "include_keywords": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 10,
                      "description": "Website keywords to include, up to 10. PRO+ only."
                    },
                    "has_investor_page": {
                      "type": "boolean",
                      "description": "Filter by investor page. PRO+ only."
                    },
                    "has_persona_pages": {
                      "type": "boolean",
                      "description": "Filter by persona pages. PRO+ only."
                    },
                    "has_security_page": {
                      "type": "boolean",
                      "description": "Filter by security page. PRO+ only."
                    },
                    "has_industry_pages": {
                      "type": "boolean",
                      "description": "Filter by industry pages. PRO+ only."
                    },
                    "has_solution_pages": {
                      "type": "boolean",
                      "description": "Filter by solution pages. PRO+ only."
                    },
                    "has_comparison_pages": {
                      "type": "boolean",
                      "description": "Filter by comparison pages. PRO+ only."
                    },
                    "has_developer_docs_page": {
                      "type": "boolean",
                      "description": "Filter by developer docs. PRO+ only."
                    }
                  },
                  "description": "Website-content criteria. PRO+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "max_person_per_company": {
                  "type": "integer",
                  "maximum": 100,
                  "minimum": 1,
                  "description": "Maximum people returned per company, 1-100."
                },
                "person_contact_details": {
                  "type": "object",
                  "properties": {
                    "email": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "const": "VERIFIED"
                      },
                      "description": "Require verified email availability; values are not revealed by search."
                    },
                    "mobile": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "VERIFIED",
                          "UNAVAILABLE"
                        ],
                        "type": "string"
                      },
                      "description": "Filter mobile availability; values are not revealed by search."
                    },
                    "operator": {
                      "enum": [
                        "OR",
                        "AND"
                      ],
                      "type": "string",
                      "description": "How email and mobile conditions combine."
                    },
                    "hide_people_with_details_already_revealed": {
                      "type": "boolean",
                      "description": "Hide people whose contact details the team already revealed."
                    }
                  },
                  "description": "Contact availability only; search never reveals email or mobile values.",
                  "additionalProperties": false
                },
                "person_location_search": {
                  "type": "object",
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 100,
                      "description": "Values to exclude, up to 100."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 100,
                      "description": "Values to include, up to 100."
                    }
                  },
                  "description": "Canonical locations from SEARCH_SUGGESTIONS, up to 100 include and exclude values.",
                  "additionalProperties": false
                },
                "company_headcount_range": {
                  "type": "array",
                  "items": {
                    "enum": [
                      "1-10",
                      "11-20",
                      "21-50",
                      "51-100",
                      "101-200",
                      "201-500",
                      "501-1000",
                      "1001-2000",
                      "2001-5000",
                      "5001-10000",
                      "10000+"
                    ],
                    "type": "string"
                  },
                  "description": "Canonical employee ranges; cannot combine with company_headcount_custom."
                },
                "company_location_search": {
                  "type": "object",
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 100,
                      "description": "Values to exclude, up to 100."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 100,
                      "description": "Values to include, up to 100."
                    }
                  },
                  "description": "Canonical company locations, up to 100 include and exclude values.",
                  "additionalProperties": false
                },
                "company_website_traffic": {
                  "type": "object",
                  "properties": {
                    "visit_change": {
                      "type": "object",
                      "properties": {
                        "period": {
                          "enum": [
                            "monthly",
                            "quarterly",
                            "yearly"
                          ],
                          "type": "string",
                          "description": "Traffic-change period. PRO+ only."
                        },
                        "max_change": {
                          "type": "number",
                          "maximum": 10000,
                          "minimum": -100,
                          "description": "Maximum traffic change. PRO+ only."
                        },
                        "min_change": {
                          "type": "number",
                          "maximum": 10000,
                          "minimum": -100,
                          "description": "Minimum traffic change. PRO+ only."
                        }
                      },
                      "description": "Traffic-change range. PRO+ only.",
                      "additionalProperties": false
                    },
                    "top_countries": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 5,
                      "minItems": 1,
                      "description": "Top visitor countries, 1-5. PRO+ only."
                    },
                    "max_country_pct": {
                      "type": "number",
                      "maximum": 100,
                      "minimum": 0,
                      "description": "Maximum country traffic percentage. PRO+ only."
                    },
                    "min_country_pct": {
                      "type": "number",
                      "maximum": 100,
                      "minimum": 0,
                      "description": "Minimum country traffic percentage. PRO+ only."
                    },
                    "max_monthly_visits": {
                      "type": "integer",
                      "maximum": 100000000,
                      "minimum": 0,
                      "description": "Maximum monthly visits. PRO+ only."
                    },
                    "min_monthly_visits": {
                      "type": "integer",
                      "maximum": 100000000,
                      "minimum": 0,
                      "description": "Minimum monthly visits. PRO+ only."
                    }
                  },
                  "description": "Website traffic criteria. PRO+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "company_google_discovery": {
                  "type": "object",
                  "required": [
                    "seo_keywords"
                  ],
                  "properties": {
                    "seo_keywords": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 100,
                      "minItems": 1,
                      "description": "SEO keywords, 1-100. PRO+ only."
                    }
                  },
                  "description": "Google SEO discovery. PRO+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "company_headcount_custom": {
                  "type": "object",
                  "properties": {
                    "max": {
                      "type": "integer",
                      "maximum": 999999,
                      "minimum": 1,
                      "description": "Inclusive maximum employee count."
                    },
                    "min": {
                      "type": "integer",
                      "maximum": 999998,
                      "minimum": 1,
                      "description": "Inclusive minimum employee count."
                    }
                  },
                  "description": "Custom employee-count range; cannot combine with company_headcount_range.",
                  "additionalProperties": false
                },
                "company_headcount_growth": {
                  "type": "object",
                  "properties": {
                    "max": {
                      "type": "integer",
                      "maximum": 10000,
                      "minimum": -100,
                      "description": "Maximum headcount growth percentage."
                    },
                    "min": {
                      "type": "integer",
                      "maximum": 10000,
                      "minimum": -100,
                      "description": "Minimum headcount growth percentage."
                    },
                    "departments": {
                      "type": "array",
                      "items": {
                        "enum": [
                          "Administrative",
                          "Consulting",
                          "Customer service",
                          "Design / UI / UX",
                          "Education",
                          "Finance",
                          "General management",
                          "HR",
                          "Legal",
                          "Marketing",
                          "Medical",
                          "Operations",
                          "Product",
                          "Project management",
                          "Real estate",
                          "Research",
                          "Sales",
                          "Technical",
                          "Trades"
                        ],
                        "type": "string"
                      },
                      "maxItems": 10,
                      "description": "Canonical departments, up to 10."
                    },
                    "timeframe_month": {
                      "enum": [
                        3,
                        6,
                        12,
                        24
                      ],
                      "type": "integer",
                      "description": "Growth measurement window in months."
                    }
                  },
                  "description": "Headcount-growth criteria.",
                  "additionalProperties": false
                },
                "person_name_or_job_title": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Free-text quick search across person name and current job title."
                },
                "company_products_services": {
                  "type": "object",
                  "properties": {
                    "products_exclude": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 10,
                      "description": "Products to exclude, up to 10; requires products_include."
                    },
                    "products_include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "Products to include, up to 20."
                    },
                    "products_match_all": {
                      "type": "boolean",
                      "description": "Require all included products."
                    },
                    "service_tags_exclude": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 10,
                      "description": "Service tags to exclude, up to 10; requires service_tags_include."
                    },
                    "service_tags_include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "Service tags to include, up to 20."
                    },
                    "service_tags_match_all": {
                      "type": "boolean",
                      "description": "Require all included service tags."
                    }
                  },
                  "description": "Products and services criteria.",
                  "additionalProperties": false
                },
                "person_year_of_experience": {
                  "type": "object",
                  "properties": {
                    "max": {
                      "type": "integer",
                      "maximum": 60,
                      "minimum": 1,
                      "description": "Maximum years of experience."
                    },
                    "min": {
                      "type": "integer",
                      "maximum": 60,
                      "minimum": 0,
                      "description": "Minimum years of experience."
                    }
                  },
                  "description": "Total years-of-experience range.",
                  "additionalProperties": false
                },
                "company_operating_languages": {
                  "type": "object",
                  "required": [
                    "include"
                  ],
                  "properties": {
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 10,
                      "minItems": 1,
                      "description": "Operating languages to include, 1-10."
                    }
                  },
                  "description": "Filter companies by languages they operate in; use Search Filter Suggestions to resolve canonical language values.",
                  "additionalProperties": false
                },
                "person_time_in_current_role": {
                  "type": "object",
                  "properties": {
                    "max": {
                      "type": "integer",
                      "maximum": 600,
                      "minimum": 0,
                      "description": "Maximum number of months."
                    },
                    "min": {
                      "type": "integer",
                      "maximum": 600,
                      "minimum": 0,
                      "description": "Minimum number of months."
                    }
                  },
                  "description": "Months in current role.",
                  "additionalProperties": false
                },
                "company_job_posting_quantity": {
                  "type": "object",
                  "properties": {
                    "max": {
                      "type": "integer",
                      "maximum": 5000,
                      "minimum": 0,
                      "description": "Maximum active postings. STARTER+ only."
                    },
                    "min": {
                      "type": "integer",
                      "maximum": 5000,
                      "minimum": 0,
                      "description": "Minimum active postings. STARTER+ only."
                    }
                  },
                  "description": "Active job-posting count. STARTER+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "person_awards_certifications": {
                  "type": "object",
                  "properties": {
                    "awards": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "Award names, up to 20. GROWTH+ only."
                    },
                    "award_issuers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "Award issuers, up to 20. GROWTH+ only."
                    },
                    "award_year_max": {
                      "type": "integer",
                      "minimum": 1900,
                      "description": "Latest award year; requires an award or issuer. GROWTH+ only."
                    },
                    "award_year_min": {
                      "type": "integer",
                      "minimum": 1900,
                      "description": "Earliest award year; requires an award or issuer. GROWTH+ only."
                    },
                    "certifications": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "Certification names, up to 20. GROWTH+ only."
                    },
                    "certification_issuers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 20,
                      "description": "Certification issuers, up to 20. GROWTH+ only."
                    },
                    "certification_year_max": {
                      "type": "integer",
                      "minimum": 1900,
                      "description": "Latest certification year; requires a certification or issuer. GROWTH+ only."
                    },
                    "certification_year_min": {
                      "type": "integer",
                      "minimum": 1900,
                      "description": "Earliest certification year; requires a certification or issuer. GROWTH+ only."
                    }
                  },
                  "description": "Awards and certifications. GROWTH+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "company_headcount_by_location": {
                  "type": "object",
                  "required": [
                    "entries"
                  ],
                  "properties": {
                    "entries": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "country"
                        ],
                        "properties": {
                          "country": {
                            "type": "string",
                            "minLength": 1,
                            "description": "Country name."
                          },
                          "max_headcount": {
                            "type": "integer",
                            "maximum": 1000000,
                            "minimum": 0,
                            "description": "Maximum country headcount."
                          },
                          "min_headcount": {
                            "type": "integer",
                            "maximum": 1000000,
                            "minimum": 0,
                            "description": "Minimum country headcount."
                          }
                        }
                      },
                      "maxItems": 10,
                      "minItems": 1,
                      "description": "Country headcount ranges, 1-10. GROWTH+ only."
                    }
                  },
                  "description": "Country headcount ranges. GROWTH+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "company_job_posting_hiring_for": {
                  "type": "object",
                  "properties": {
                    "exclude": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 500,
                      "description": "Job titles to exclude. STARTER+ only."
                    },
                    "include": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "maxItems": 500,
                      "description": "Job titles to include. STARTER+ only."
                    },
                    "match_type": {
                      "enum": [
                        "contains",
                        "exact"
                      ],
                      "type": "string",
                      "description": "Job-title match type. STARTER+ only."
                    },
                    "boolean_search": {
                      "type": "string",
                      "description": "Boolean job-title query. STARTER+ only; cannot combine with include or exclude."
                    }
                  },
                  "description": "Hiring-title criteria. STARTER+ only; lower plans return PLAN_REQUIRED.",
                  "additionalProperties": false
                },
                "person_time_in_current_company": {
                  "type": "object",
                  "properties": {
                    "max": {
                      "type": "integer",
                      "maximum": 600,
                      "minimum": 0,
                      "description": "Maximum number of months."
                    },
                    "min": {
                      "type": "integer",
                      "maximum": 600,
                      "minimum": 0,
                      "description": "Minimum number of months."
                    }
                  },
                  "description": "Months at current company.",
                  "additionalProperties": false
                },
                "company_headcount_by_department": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "department"
                    ],
                    "properties": {
                      "max": {
                        "type": "integer",
                        "maximum": 100000,
                        "minimum": 0,
                        "description": "Maximum department headcount."
                      },
                      "min": {
                        "type": "integer",
                        "maximum": 100000,
                        "minimum": 0,
                        "description": "Minimum department headcount."
                      },
                      "department": {
                        "enum": [
                          "C-Suite",
                          "Chief Executive",
                          "Finance Executive",
                          "Founder",
                          "Human Resources Executive",
                          "Information Technology Executive",
                          "Legal Executive",
                          "Marketing Executive",
                          "Medical & Health Executive",
                          "Operations Executive",
                          "Sales Leader",
                          "Product",
                          "Product Development",
                          "Product Management",
                          "Other Product",
                          "Engineering & Technical",
                          "Artificial Intelligence / Machine Learning",
                          "Bioengineering",
                          "Biometrics",
                          "Business Intelligence",
                          "Chemical Engineering",
                          "Data Science & Analysis",
                          "DevOps",
                          "Digital Transformation",
                          "Emerging Technology / Innovation",
                          "Industrial Engineering",
                          "Mechanic",
                          "Mobile Development",
                          "Project Management",
                          "Research & Development",
                          "Scrum Master / Agile Coach",
                          "Software Development",
                          "Technician",
                          "Technology Operations",
                          "Test / Quality Assurance",
                          "Consulting",
                          "Consultant",
                          "Design",
                          "Other Design",
                          "Graphic / Visual / Brand Design",
                          "Education & Coaching",
                          "Teacher",
                          "Superintendent",
                          "Professor",
                          "Coach / Trainer",
                          "Finance",
                          "Financial Reporting",
                          "Financial Systems",
                          "Accounting",
                          "Finance & Banking",
                          "Financial Planning, Strategy & Analysis",
                          "Internal Audit & Control",
                          "Investor Relations",
                          "Mergers & Acquisitions",
                          "Real Estate Finance",
                          "Financial Risk",
                          "Sourcing / Procurement",
                          "Tax",
                          "Treasury",
                          "Human Resources",
                          "Compensation & Benefits",
                          "Culture, Diversity & Inclusion",
                          "Health & Safety",
                          "Other Human Resources",
                          "HR Business Partner",
                          "Learning & Development",
                          "Organizational Development",
                          "Recruiting & Talent Acquisition",
                          "Talent Management",
                          "Workforce Management",
                          "People Operations",
                          "Information Technology",
                          "Cloud Engineering",
                          "Data Center",
                          "Data Warehouse",
                          "Database Administration",
                          "eCommerce Development",
                          "Help Desk / Desktop Services",
                          "Information Security",
                          "IT Asset Management",
                          "IT Audit / IT Compliance",
                          "IT Recruitement",
                          "IT Procurement",
                          "IT Strategy",
                          "IT Training",
                          "Networking",
                          "Technical Lead",
                          "Quality Assurance",
                          "Retail / Store Systems",
                          "Servers",
                          "Disaster Recovery",
                          "Telecommunications",
                          "Legal",
                          "Compliance",
                          "Contracts",
                          "Corporate Secretary",
                          "eDiscovery",
                          "Ethics",
                          "Governance",
                          "Governmental Affairs & Regulatory Law",
                          "Intellectual Property & Patent",
                          "Labor & Employment",
                          "Lawyer / Attorney",
                          "Other Legal",
                          "Legal Counsel",
                          "Legal Operations",
                          "Litigation",
                          "Privacy",
                          "Marketing",
                          "Advertising",
                          "Brand Management",
                          "Content Marketing",
                          "Customer Experience",
                          "Customer Marketing",
                          "Growth & Demand Generation",
                          "Digital Marketing",
                          "eCommerce Marketing",
                          "Event & Field Marketing",
                          "Lead Generation",
                          "Marketing Operations",
                          "Product Marketing",
                          "Public Relations",
                          "SEO",
                          "Social Media Marketing",
                          "Technical Marketing",
                          "Medical & Health",
                          "Anesthesiology",
                          "Chiropractics",
                          "Clinical Systems",
                          "Dentistry",
                          "Dermatology",
                          "Doctors / Physicians",
                          "Epidemiology",
                          "Fire Responder",
                          "Infectious Disease",
                          "Medical Administration",
                          "Medical Education & Training",
                          "Clinical Research",
                          "Neurology",
                          "Nursing",
                          "Nutrition & Dietetics",
                          "Obstetrics / Gynecology",
                          "Oncology",
                          "Opthalmology",
                          "Optometry",
                          "Orthopedics",
                          "Radiology",
                          "Public Health",
                          "Psychology",
                          "Psychiatry",
                          "Physical Therapy",
                          "Pharmacy",
                          "Pediatrics",
                          "Pathology",
                          "Operations",
                          "Supply Chain",
                          "Store Operations",
                          "Safety",
                          "Real Estate",
                          "Quality Management",
                          "Physical Security",
                          "Office Operations",
                          "Logistics",
                          "Leasing",
                          "Facilities Management",
                          "Customer Service / Support",
                          "Corporate Strategy",
                          "Construction",
                          "Call Center",
                          "Sales",
                          "Other Sales",
                          "Sales Training",
                          "Sales Operations",
                          "Sales Engineering",
                          "Sales Enablement",
                          "Revenue Operations",
                          "Partnerships",
                          "Sales Development",
                          "Account Executive",
                          "Field / Outside Sales",
                          "Customer Success",
                          "Customer Retention & Development",
                          "Channel Sales",
                          "Account Management"
                        ],
                        "type": "string",
                        "description": "Canonical department name."
                      }
                    }
                  },
                  "maxItems": 10,
                  "description": "Department-specific headcount ranges, up to 10."
                }
              },
              "description": "Typed person and company filters. Required on the first page and restored automatically from next_cursor on continuation pages. At least one positive filter is required. Dashboard-only persona_ids, company_list_oids, and temp_matching_oids are not supported.",
              "additionalProperties": false
            },
            "next_cursor": {
              "type": "string",
              "description": "Opaque cursor from a prior response. Omit for page one; when provided, omit filters because the cursor restores them and advances one page."
            }
          }
        }
      }
    }
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "response_units",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.0243,
    "estimate_source": "profile_seed",
    "evidence_source": "response_body",
    "maximum_units": 10000000,
    "unit": "provider_credit",
    "unit_rate_usd": 1e-06
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}
```

## 费用与请求规则

按用量计费；默认请求预估费用：\$0.0243 USD（不是固定价格）。 声明的单位费率：每 provider\_credit \$0.000001 USD。 最终费用以账户适用价格及实际结算为准。

公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。

* **默认请求参考估价（USD）:** 0.0243
* **声明的单位费率（USD）:** 1e-06
* **计费单位:** provider\_credit
* **计费依据:** response\_units
* **公开参考倍率:** 1.0
* **声明的最大计数或单位数:** 10000000
* **结算证据来源:** response\_body


## OpenAPI

````yaml reference-contracts/zh/prospeo.json POST /apis/v1/prospeo/search-people
openapi: 3.1.0
info:
  description: ''
  title: Prospeo
  version: '1'
  x-aisa-capabilities:
    idempotency: Idempotency-Key
    max_price: X-AISA-Max-Price-USD
    quote:
      header: X-AISA-Cost-Mode
      value: quote
  x-aisa-configured-paths:
    - /apis/v1/prospeo/bulk-enrich-people
    - /apis/v1/prospeo/companies-enrich
    - /apis/v1/prospeo/companies-search
    - /apis/v1/prospeo/enrich-company
    - /apis/v1/prospeo/enrich-person
    - /apis/v1/prospeo/people-email-find
    - /apis/v1/prospeo/people-enrich
    - /apis/v1/prospeo/people-phone-find
    - /apis/v1/prospeo/people-search
    - /apis/v1/prospeo/search-companies
    - /apis/v1/prospeo/search-people
  x-aisa-document:
    facts_hash: 14747b6d3b7c1fb8f4ed610011f8f5654aa07f8d884665f33860fa90664909fa
    generator_version: '3'
    protocol_version: '1'
    schema_version: '1'
    composer_version: '28'
    response_pending: []
    document_hash: sha256:800c53f325e017eb334f7f939c4188d558bb0146a82770dbae46c0b909468190
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: prospeo
  x-aisa-catalogs:
    prospeo:
      title: Prospeo
      description: ''
      x-aisa-document:
        facts_hash: 14747b6d3b7c1fb8f4ed610011f8f5654aa07f8d884665f33860fa90664909fa
        generator_version: '3'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/prospeo/search-people:
    post:
      tags:
        - Prospeo
      summary: Search People
      description: >-
        <!-- aisa-pricing:start -->

        按用量计费；默认请求预估费用：$0.0243 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001
        USD。 最终费用以账户适用价格及实际结算为准。

        <!-- aisa-pricing:end -->
      operationId: prospeo.search-people
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                filters:
                  type: object
                  examples:
                    - company:
                        websites:
                          include:
                            - openai.com
                  properties:
                    company:
                      type: object
                      properties:
                        names:
                          type: object
                          properties:
                            exclude:
                              type: array
                              items:
                                type: string
                              maxItems: 500
                              description: Values to exclude, up to 500.
                            include:
                              type: array
                              items:
                                type: string
                              maxItems: 500
                              description: Values to include, up to 500.
                          description: Company names to include or exclude.
                          additionalProperties: false
                        websites:
                          type: object
                          properties:
                            exclude:
                              type: array
                              items:
                                type: string
                              maxItems: 500
                              description: Values to exclude, up to 500.
                            include:
                              type: array
                              items:
                                type: string
                              maxItems: 500
                              description: Values to include, up to 500.
                          description: >-
                            Root company websites or domains to include or
                            exclude.
                          additionalProperties: false
                        company_oids:
                          type: object
                          properties:
                            exclude:
                              type: array
                              items:
                                type: string
                              maxItems: 5000
                              description: Prospeo company IDs to exclude, up to 5,000.
                            include:
                              type: array
                              items:
                                type: string
                              maxItems: 5000
                              description: Prospeo company IDs to include, up to 5,000.
                          description: >-
                            Prospeo company IDs to include or exclude. Valid for
                            person search, up to 5,000 values overall.
                          additionalProperties: false
                      description: >-
                        Company names, websites, or IDs. Company IDs are
                        supported in person search.
                      additionalProperties: false
                    company_icp:
                      type: object
                      properties:
                        industries:
                          type: array
                          items:
                            type: string
                          maxItems: 10
                          description: ICP industries, up to 10. GROWTH+ only.
                        departments:
                          type: object
                          properties:
                            other:
                              type: array
                              items:
                                type: string
                              maxItems: 5
                              description: Other departments, up to 5. GROWTH+ only.
                            include:
                              type: array
                              items:
                                enum:
                                  - Engineering
                                  - Sales
                                  - Marketing
                                  - Finance
                                  - HR
                                  - Operations
                                  - IT
                                  - Legal
                                  - Customer Success
                                  - Procurement
                                  - Data
                                  - Security
                                  - Design
                                  - SMB Owners
                                  - Consumers
                                type: string
                              maxItems: 15
                              description: Canonical departments, up to 15. GROWTH+ only.
                            match_mode:
                              enum:
                                - any
                                - all
                              type: string
                              description: Department match mode. GROWTH+ only.
                          description: ICP department criteria. GROWTH+ only.
                          additionalProperties: false
                        company_sizes:
                          type: array
                          items:
                            enum:
                              - micro
                              - smb
                              - midmarket
                              - enterprise
                              - large_enterprise
                            type: string
                          description: ICP company sizes. GROWTH+ only.
                        titles_exclude:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: ICP titles to exclude, up to 20. GROWTH+ only.
                        titles_include:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: ICP titles to include, up to 20. GROWTH+ only.
                        geographic_scope:
                          enum:
                            - single_country
                            - multi_country
                          type: string
                          description: ICP geographic scope. GROWTH+ only.
                        geographic_markets:
                          type: array
                          items:
                            type: string
                          maxItems: 10
                          description: ICP geographic markets, up to 10. GROWTH+ only.
                      description: >-
                        Ideal-customer-profile criteria. GROWTH+ only; lower
                        plans return PLAN_REQUIRED.
                      additionalProperties: false
                    person_name:
                      type: object
                      properties:
                        exclude:
                          type: array
                          items:
                            type: string
                          maxItems: 500
                          description: Names to exclude, up to 500.
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 500
                          description: Names to include, up to 500.
                        person_oids:
                          type: array
                          items:
                            type: string
                          maxItems: 50
                          description: Prospeo person IDs, up to 50.
                      description: >-
                        Strict person names or IDs. Mutually exclusive with
                        person_search.
                      additionalProperties: false
                    company_news:
                      type: object
                      properties:
                        keywords:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: News keywords, up to 20.
                        categories:
                          type: array
                          items:
                            enum:
                              - Funding & Investment
                              - Mergers & Acquisitions
                              - Product Launch
                              - Partnership
                              - Expansion
                              - Layoffs & Restructuring
                              - IPO
                              - Leadership Change
                              - Legal & Regulatory
                              - Awards & Recognition
                            type: string
                          maxItems: 10
                          description: News categories, up to 10.
                        timeframe_days:
                          enum:
                            - 60
                            - 90
                            - 180
                            - 365
                          type: integer
                          description: News lookback window in days.
                      description: Company-news criteria.
                      additionalProperties: false
                    company_sics:
                      type: object
                      properties:
                        exclude:
                          type: array
                          items:
                            type: integer
                          maxItems: 100
                          description: Codes to exclude, up to 100.
                        include:
                          type: array
                          items:
                            type: integer
                          maxItems: 100
                          description: Codes to include, up to 100.
                      description: SIC codes resolved through SEARCH_SUGGESTIONS.
                      additionalProperties: false
                    company_type:
                      anyOf:
                        - type: object
                          title: CompanyTypeDetails
                          properties:
                            status:
                              anyOf:
                                - enum:
                                    - Private
                                    - Public
                                    - Non Profit
                                    - Other
                                  type: string
                                - type: 'null'
                              title: Status
                              default: null
                              description: Company ownership status.
                            subtypes:
                              anyOf:
                                - type: object
                                  title: CompanySubtypeFilter
                                  properties:
                                    exclude:
                                      anyOf:
                                        - type: array
                                          items:
                                            enum:
                                              - SaaS
                                              - Marketplace
                                              - E-commerce
                                              - Agency
                                              - Consulting
                                              - Manufacturing
                                              - Media/Publisher
                                              - Education
                                              - Non-Profit
                                              - Government
                                              - FinTech
                                              - HealthTech
                                              - AI/ML
                                              - Hardware
                                              - Professional Services
                                              - Platform
                                              - Data/Analytics
                                              - Franchise
                                              - Logistics
                                              - Real Estate
                                              - Legal
                                              - Insurance
                                              - Retail
                                              - Hospitality
                                              - Food & Beverage
                                              - Construction
                                              - Telecommunications
                                            type: string
                                        - type: 'null'
                                      title: Exclude
                                      default: null
                                      description: Company subtypes to exclude.
                                    include:
                                      anyOf:
                                        - type: array
                                          items:
                                            enum:
                                              - SaaS
                                              - Marketplace
                                              - E-commerce
                                              - Agency
                                              - Consulting
                                              - Manufacturing
                                              - Media/Publisher
                                              - Education
                                              - Non-Profit
                                              - Government
                                              - FinTech
                                              - HealthTech
                                              - AI/ML
                                              - Hardware
                                              - Professional Services
                                              - Platform
                                              - Data/Analytics
                                              - Franchise
                                              - Logistics
                                              - Real Estate
                                              - Legal
                                              - Insurance
                                              - Retail
                                              - Hospitality
                                              - Food & Beverage
                                              - Construction
                                              - Telecommunications
                                            type: string
                                        - type: 'null'
                                      title: Include
                                      default: null
                                      description: Company subtypes to include.
                                - type: 'null'
                              default: null
                              description: Company subtypes to include or exclude.
                            is_retail:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                              title: Is Retail
                              default: null
                              description: Filter retail companies.
                            is_mainly_ai:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                              title: Is Mainly Ai
                              default: null
                              description: Filter primarily AI companies.
                            is_sales_led:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                              title: Is Sales Led
                              default: null
                              description: Filter sales-led companies.
                            has_free_tier:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                              title: Has Free Tier
                              default: null
                              description: Filter by free-tier availability.
                            is_self_serve:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                              title: Is Self Serve
                              default: null
                              description: Filter self-serve companies.
                            multi_product:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                              title: Multi Product
                              default: null
                              description: Filter multi-product companies.
                            business_model:
                              anyOf:
                                - enum:
                                    - b2b
                                    - b2c
                                    - b2b2c
                                    - d2c
                                    - marketplace
                                    - franchise
                                    - non_profit
                                    - government
                                  type: string
                                - type: array
                                  items:
                                    enum:
                                      - b2b
                                      - b2c
                                      - b2b2c
                                      - d2c
                                      - marketplace
                                      - franchise
                                      - non_profit
                                      - government
                                    type: string
                                - type: 'null'
                              title: Business Model
                              default: null
                              description: Business model or models.
                            is_marketplace:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                              title: Is Marketplace
                              default: null
                              description: Filter marketplace companies.
                            has_subscription:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                              title: Has Subscription
                              default: null
                              description: Filter by subscription offering.
                            is_mainly_crypto:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                              title: Is Mainly Crypto
                              default: null
                              description: Filter primarily crypto companies.
                            has_usage_pricing:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                              title: Has Usage Pricing
                              default: null
                              description: Filter by usage-based pricing.
                            has_public_pricing:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                              title: Has Public Pricing
                              default: null
                              description: Filter by public pricing.
                            has_enterprise_plan:
                              anyOf:
                                - type: boolean
                                - type: 'null'
                              title: Has Enterprise Plan
                              default: null
                              description: Filter by enterprise-plan availability.
                        - enum:
                            - Private
                            - Public
                            - Non Profit
                            - Other
                          type: string
                      description: >-
                        Company ownership status or detailed company-type
                        facets. Available on FREE.
                    company_naics:
                      type: object
                      properties:
                        exclude:
                          type: array
                          items:
                            type: integer
                          maxItems: 100
                          description: Codes to exclude, up to 100.
                        include:
                          type: array
                          items:
                            type: integer
                          maxItems: 100
                          description: Codes to include, up to 100.
                      description: NAICS codes resolved through SEARCH_SUGGESTIONS.
                      additionalProperties: false
                    person_search:
                      type: object
                      properties:
                        exclude:
                          type: array
                          items:
                            type: string
                          maxItems: 500
                          description: >-
                            Broad person terms to exclude, up to 500; each 1-100
                            characters.
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 500
                          description: >-
                            Broad person terms to include, up to 500; each 1-100
                            characters.
                        match_mode:
                          enum:
                            - SMART
                            - STRICT
                          type: string
                          description: Broad person-term match mode.
                      description: Broad person terms. Mutually exclusive with person_name.
                      additionalProperties: false
                    company_awards:
                      type: object
                      required:
                        - include
                      properties:
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 50
                          minItems: 1
                          description: Awards to include, 1-50. GROWTH+ only.
                        match_mode:
                          enum:
                            - EXACT
                            - CONTAINS
                          type: string
                          description: Award match mode. GROWTH+ only.
                      description: >-
                        Company awards. GROWTH+ only; lower plans return
                        PLAN_REQUIRED.
                      additionalProperties: false
                    company_intent:
                      type: object
                      required:
                        - topic_ids
                      properties:
                        topic_ids:
                          type: array
                          items:
                            type: string
                          maxItems: 30
                          minItems: 1
                          description: >-
                            Account-specific dashboard topic IDs, 1-30; this API
                            cannot discover them.
                        early_research:
                          type: boolean
                          description: Require early research intent.
                        active_research:
                          type: boolean
                          description: Require active research intent.
                        in_depth_research:
                          type: boolean
                          description: Require in-depth research intent.
                      description: >-
                        Intent topics from the Prospeo dashboard; topic IDs
                        cannot be discovered through this API.
                      additionalProperties: false
                    company_founded:
                      type: object
                      properties:
                        max:
                          type: integer
                          minimum: 1900
                          description: Latest founding year.
                        min:
                          type: integer
                          minimum: 1900
                          description: Earliest founding year.
                        include_unknown_founded:
                          type: boolean
                          description: Include companies with unknown founding year.
                      description: Founding-year range.
                      additionalProperties: false
                    company_funding:
                      type: object
                      properties:
                        stage:
                          type: array
                          items:
                            enum:
                              - Angel
                              - Convertible note
                              - Corporate round
                              - Debt financing
                              - Equity crowdfunding
                              - Grant
                              - Initial coin offering
                              - Non equity assistance
                              - Post IPO debt
                              - Post IPO equity
                              - Post IPO secondary
                              - Pre seed
                              - Private equity
                              - Product crowdfunding
                              - Secondary market
                              - Seed
                              - Series A
                              - Series B
                              - Series C
                              - Series D
                              - Series E-J
                              - Series unknown
                              - Undisclosed
                            type: string
                          maxItems: 500
                          description: Funding stages, up to 500. STARTER+ only.
                        investors:
                          type: array
                          items:
                            type: string
                          maxItems: 10
                          description: Investors, up to 10. STARTER+ only.
                        funding_date:
                          enum:
                            - 30
                            - 60
                            - 90
                            - 180
                            - 270
                            - 365
                          type: integer
                          description: Days since funding. STARTER+ only.
                        last_funding:
                          type: object
                          properties:
                            max:
                              enum:
                                - <100K
                                - 100K
                                - 500K
                                - 1M
                                - 5M
                                - 10M
                                - 25M
                                - 50M
                                - 100M
                                - 250M
                                - 500M
                                - 1B
                                - 5B
                                - 10B+
                              type: string
                              description: Inclusive maximum revenue band.
                            min:
                              enum:
                                - <100K
                                - 100K
                                - 500K
                                - 1M
                                - 5M
                                - 10M
                                - 25M
                                - 50M
                                - 100M
                                - 250M
                                - 500M
                                - 1B
                                - 5B
                                - 10B+
                              type: string
                              description: Inclusive minimum revenue band.
                          description: Latest funding amount range. STARTER+ only.
                          additionalProperties: false
                        total_funding:
                          type: object
                          properties:
                            max:
                              enum:
                                - <100K
                                - 100K
                                - 500K
                                - 1M
                                - 5M
                                - 10M
                                - 25M
                                - 50M
                                - 100M
                                - 250M
                                - 500M
                                - 1B
                                - 5B
                                - 10B+
                              type: string
                              description: Inclusive maximum revenue band.
                            min:
                              enum:
                                - <100K
                                - 100K
                                - 500K
                                - 1M
                                - 5M
                                - 10M
                                - 25M
                                - 50M
                                - 100M
                                - 250M
                                - 500M
                                - 1B
                                - 5B
                                - 10B+
                              type: string
                              description: Inclusive minimum revenue band.
                          description: Total funding amount range. STARTER+ only.
                          additionalProperties: false
                        accelerator_name:
                          type: string
                          description: Accelerator name. STARTER+ only.
                        was_in_accelerator:
                          type: boolean
                          description: Filter accelerator participation. STARTER+ only.
                      description: >-
                        Funding criteria. STARTER+ only; FREE returns
                        PLAN_REQUIRED.
                      additionalProperties: false
                    company_revenue:
                      type: object
                      properties:
                        max:
                          enum:
                            - <100K
                            - 100K
                            - 500K
                            - 1M
                            - 5M
                            - 10M
                            - 25M
                            - 50M
                            - 100M
                            - 250M
                            - 500M
                            - 1B
                            - 5B
                            - 10B+
                          type: string
                          description: Maximum revenue bucket. STARTER+ only.
                        min:
                          enum:
                            - <100K
                            - 100K
                            - 500K
                            - 1M
                            - 5M
                            - 10M
                            - 25M
                            - 50M
                            - 100M
                            - 250M
                            - 500M
                            - 1B
                            - 5B
                            - 10B+
                          type: string
                          description: Minimum revenue bucket. STARTER+ only.
                        include_unknown_revenue:
                          type: boolean
                          description: >-
                            Include companies with unknown revenue. STARTER+
                            only.
                      description: >-
                        Revenue criteria. STARTER+ only; FREE returns
                        PLAN_REQUIRED.
                      additionalProperties: false
                    company_industry:
                      type: object
                      properties:
                        exclude:
                          type: array
                          items:
                            type: string
                          maxItems: 500
                          description: Values to exclude, up to 500.
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 500
                          description: Values to include, up to 500.
                      description: Canonical company industries.
                      additionalProperties: false
                    company_keywords:
                      type: object
                      required:
                        - include
                      properties:
                        exclude:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: Keywords to exclude, up to 20.
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          minItems: 1
                          description: Keywords to include; 1-20 are required.
                        sources:
                          type: array
                          items:
                            enum:
                              - specialties
                              - social_media_description
                              - seo_description
                              - ai_description
                              - products_services
                              - website_pages
                            type: string
                          description: Company text sources to search.
                        include_all:
                          type: boolean
                          description: >-
                            Require all included keywords instead of any
                            keyword.
                        search_everywhere:
                          type: boolean
                          description: Search all supported company text sources.
                      description: Company keyword criteria.
                      additionalProperties: false
                    person_education:
                      type: object
                      properties:
                        degrees:
                          type: array
                          items:
                            enum:
                              - high school
                              - associate
                              - bachelors
                              - masters
                              - mba
                              - phd
                              - professional
                              - diploma
                              - vocational
                              - other
                            type: string
                          description: Degree levels. GROWTH+ only.
                        schools:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: Schools, up to 20. GROWTH+ only.
                        graduated_max:
                          type: integer
                          minimum: 1950
                          description: Latest graduation year. GROWTH+ only.
                        graduated_min:
                          type: integer
                          minimum: 1950
                          description: Earliest graduation year. GROWTH+ only.
                        fields_of_study:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: Fields of study, up to 20. GROWTH+ only.
                      description: >-
                        Education criteria. GROWTH+ only; lower plans return
                        PLAN_REQUIRED.
                      additionalProperties: false
                    person_job_title:
                      type: object
                      properties:
                        exclude:
                          type: array
                          items:
                            type: string
                          maxItems: 100
                          description: Current job titles to exclude, up to 100.
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 100
                          description: Current job titles to include, up to 100.
                        match_mode:
                          enum:
                            - CONTAINS
                            - EXACT
                            - SIMILAR
                          type: string
                          description: Job-title match mode.
                        boolean_search:
                          type: string
                          description: >-
                            Boolean current-title query; cannot combine with
                            include or exclude.
                        smart_intensity:
                          enum:
                            - LOOSE
                            - NORMAL
                            - STRICT
                          type: string
                          description: Similarity intensity for smart title matching.
                      description: Current job-title criteria.
                      additionalProperties: false
                    person_seniority:
                      type: object
                      properties:
                        exclude:
                          type: array
                          items:
                            enum:
                              - C-Suite
                              - Director
                              - Entry
                              - Founder/Owner
                              - Head
                              - Intern
                              - Manager
                              - Partner
                              - Senior
                              - Vice President
                            type: string
                          maxItems: 11
                          description: Canonical seniorities to exclude, up to 11.
                        include:
                          type: array
                          items:
                            enum:
                              - C-Suite
                              - Director
                              - Entry
                              - Founder/Owner
                              - Head
                              - Intern
                              - Manager
                              - Partner
                              - Senior
                              - Vice President
                            type: string
                          maxItems: 11
                          description: Canonical seniorities to include, up to 11.
                      description: >-
                        Canonical seniorities, at most 11; include and exclude
                        are mutually exclusive.
                      additionalProperties: false
                    company_key_execs:
                      type: object
                      required:
                        - event_types
                      properties:
                        event_types:
                          type: array
                          items:
                            enum:
                              - CEO Departed
                              - CEO Appointed
                              - CTO Departed
                              - CTO Appointed
                              - CFO Departed
                              - CFO Appointed
                              - COO Departed
                              - COO Appointed
                              - CMO Departed
                              - CMO Appointed
                              - CRO Departed
                              - CRO Appointed
                              - VP of Sales Departed
                              - VP of Sales Appointed
                              - VP of Marketing Departed
                              - VP of Marketing Appointed
                              - VP of Engineering Departed
                              - VP of Engineering Appointed
                              - Any C-Level Departed
                              - Any C-Level Appointed
                              - Any VP Departed
                              - Any VP Appointed
                              - Any Director Departed
                              - Any Director Appointed
                            type: string
                          maxItems: 10
                          minItems: 1
                          description: Executive event types, 1-10. PRO+ only.
                        timeframe_days:
                          enum:
                            - 60
                            - 90
                            - 180
                            - 365
                          type: integer
                          description: Executive-event lookback in days. PRO+ only.
                      description: >-
                        Key-executive events. PRO+ only; lower plans return
                        PLAN_REQUIRED.
                      additionalProperties: false
                    company_lookalike:
                      type: object
                      properties:
                        domain:
                          type: string
                          description: Seed company domain. STARTER+ only.
                        icp_text:
                          type: string
                          maxLength: 5000
                          description: >-
                            Ideal-customer description, up to 5,000 characters.
                            STARTER+ only.
                        match_all:
                          type: boolean
                          description: Require all lookalike dimensions. STARTER+ only.
                        person_oids:
                          type: array
                          items:
                            type: string
                          maxItems: 10
                          description: >-
                            Seed person IDs, up to 10; valid for person search.
                            STARTER+ only.
                        company_oids:
                          type: array
                          items:
                            type: string
                          maxItems: 10
                          description: Seed company IDs, up to 10. STARTER+ only.
                        minimum_tier:
                          enum:
                            - T1
                            - T2
                            - T3
                          type: string
                          description: Minimum match tier. STARTER+ only.
                        same_language:
                          type: boolean
                          description: Require the same language. STARTER+ only.
                      description: >-
                        Exactly one lookalike seed mode. STARTER+ only;
                        person_oids are valid in this person search.
                      additionalProperties: false
                    person_department:
                      type: object
                      properties:
                        exclude:
                          type: array
                          items:
                            enum:
                              - C-Suite
                              - Chief Executive
                              - Finance Executive
                              - Founder
                              - Human Resources Executive
                              - Information Technology Executive
                              - Legal Executive
                              - Marketing Executive
                              - Medical & Health Executive
                              - Operations Executive
                              - Sales Leader
                              - Product
                              - Product Development
                              - Product Management
                              - Other Product
                              - Engineering & Technical
                              - Artificial Intelligence / Machine Learning
                              - Bioengineering
                              - Biometrics
                              - Business Intelligence
                              - Chemical Engineering
                              - Data Science & Analysis
                              - DevOps
                              - Digital Transformation
                              - Emerging Technology / Innovation
                              - Industrial Engineering
                              - Mechanic
                              - Mobile Development
                              - Project Management
                              - Research & Development
                              - Scrum Master / Agile Coach
                              - Software Development
                              - Technician
                              - Technology Operations
                              - Test / Quality Assurance
                              - Consulting
                              - Consultant
                              - Design
                              - Other Design
                              - Graphic / Visual / Brand Design
                              - Education & Coaching
                              - Teacher
                              - Superintendent
                              - Professor
                              - Coach / Trainer
                              - Finance
                              - Financial Reporting
                              - Financial Systems
                              - Accounting
                              - Finance & Banking
                              - Financial Planning, Strategy & Analysis
                              - Internal Audit & Control
                              - Investor Relations
                              - Mergers & Acquisitions
                              - Real Estate Finance
                              - Financial Risk
                              - Sourcing / Procurement
                              - Tax
                              - Treasury
                              - Human Resources
                              - Compensation & Benefits
                              - Culture, Diversity & Inclusion
                              - Health & Safety
                              - Other Human Resources
                              - HR Business Partner
                              - Learning & Development
                              - Organizational Development
                              - Recruiting & Talent Acquisition
                              - Talent Management
                              - Workforce Management
                              - People Operations
                              - Information Technology
                              - Cloud Engineering
                              - Data Center
                              - Data Warehouse
                              - Database Administration
                              - eCommerce Development
                              - Help Desk / Desktop Services
                              - Information Security
                              - IT Asset Management
                              - IT Audit / IT Compliance
                              - IT Recruitement
                              - IT Procurement
                              - IT Strategy
                              - IT Training
                              - Networking
                              - Technical Lead
                              - Quality Assurance
                              - Retail / Store Systems
                              - Servers
                              - Disaster Recovery
                              - Telecommunications
                              - Legal
                              - Compliance
                              - Contracts
                              - Corporate Secretary
                              - eDiscovery
                              - Ethics
                              - Governance
                              - Governmental Affairs & Regulatory Law
                              - Intellectual Property & Patent
                              - Labor & Employment
                              - Lawyer / Attorney
                              - Other Legal
                              - Legal Counsel
                              - Legal Operations
                              - Litigation
                              - Privacy
                              - Marketing
                              - Advertising
                              - Brand Management
                              - Content Marketing
                              - Customer Experience
                              - Customer Marketing
                              - Growth & Demand Generation
                              - Digital Marketing
                              - eCommerce Marketing
                              - Event & Field Marketing
                              - Lead Generation
                              - Marketing Operations
                              - Product Marketing
                              - Public Relations
                              - SEO
                              - Social Media Marketing
                              - Technical Marketing
                              - Medical & Health
                              - Anesthesiology
                              - Chiropractics
                              - Clinical Systems
                              - Dentistry
                              - Dermatology
                              - Doctors / Physicians
                              - Epidemiology
                              - Fire Responder
                              - Infectious Disease
                              - Medical Administration
                              - Medical Education & Training
                              - Clinical Research
                              - Neurology
                              - Nursing
                              - Nutrition & Dietetics
                              - Obstetrics / Gynecology
                              - Oncology
                              - Opthalmology
                              - Optometry
                              - Orthopedics
                              - Radiology
                              - Public Health
                              - Psychology
                              - Psychiatry
                              - Physical Therapy
                              - Pharmacy
                              - Pediatrics
                              - Pathology
                              - Operations
                              - Supply Chain
                              - Store Operations
                              - Safety
                              - Real Estate
                              - Quality Management
                              - Physical Security
                              - Office Operations
                              - Logistics
                              - Leasing
                              - Facilities Management
                              - Customer Service / Support
                              - Corporate Strategy
                              - Construction
                              - Call Center
                              - Sales
                              - Other Sales
                              - Sales Training
                              - Sales Operations
                              - Sales Engineering
                              - Sales Enablement
                              - Revenue Operations
                              - Partnerships
                              - Sales Development
                              - Account Executive
                              - Field / Outside Sales
                              - Customer Success
                              - Customer Retention & Development
                              - Channel Sales
                              - Account Management
                            type: string
                          maxItems: 100
                          description: Canonical values to exclude.
                        include:
                          type: array
                          items:
                            enum:
                              - C-Suite
                              - Chief Executive
                              - Finance Executive
                              - Founder
                              - Human Resources Executive
                              - Information Technology Executive
                              - Legal Executive
                              - Marketing Executive
                              - Medical & Health Executive
                              - Operations Executive
                              - Sales Leader
                              - Product
                              - Product Development
                              - Product Management
                              - Other Product
                              - Engineering & Technical
                              - Artificial Intelligence / Machine Learning
                              - Bioengineering
                              - Biometrics
                              - Business Intelligence
                              - Chemical Engineering
                              - Data Science & Analysis
                              - DevOps
                              - Digital Transformation
                              - Emerging Technology / Innovation
                              - Industrial Engineering
                              - Mechanic
                              - Mobile Development
                              - Project Management
                              - Research & Development
                              - Scrum Master / Agile Coach
                              - Software Development
                              - Technician
                              - Technology Operations
                              - Test / Quality Assurance
                              - Consulting
                              - Consultant
                              - Design
                              - Other Design
                              - Graphic / Visual / Brand Design
                              - Education & Coaching
                              - Teacher
                              - Superintendent
                              - Professor
                              - Coach / Trainer
                              - Finance
                              - Financial Reporting
                              - Financial Systems
                              - Accounting
                              - Finance & Banking
                              - Financial Planning, Strategy & Analysis
                              - Internal Audit & Control
                              - Investor Relations
                              - Mergers & Acquisitions
                              - Real Estate Finance
                              - Financial Risk
                              - Sourcing / Procurement
                              - Tax
                              - Treasury
                              - Human Resources
                              - Compensation & Benefits
                              - Culture, Diversity & Inclusion
                              - Health & Safety
                              - Other Human Resources
                              - HR Business Partner
                              - Learning & Development
                              - Organizational Development
                              - Recruiting & Talent Acquisition
                              - Talent Management
                              - Workforce Management
                              - People Operations
                              - Information Technology
                              - Cloud Engineering
                              - Data Center
                              - Data Warehouse
                              - Database Administration
                              - eCommerce Development
                              - Help Desk / Desktop Services
                              - Information Security
                              - IT Asset Management
                              - IT Audit / IT Compliance
                              - IT Recruitement
                              - IT Procurement
                              - IT Strategy
                              - IT Training
                              - Networking
                              - Technical Lead
                              - Quality Assurance
                              - Retail / Store Systems
                              - Servers
                              - Disaster Recovery
                              - Telecommunications
                              - Legal
                              - Compliance
                              - Contracts
                              - Corporate Secretary
                              - eDiscovery
                              - Ethics
                              - Governance
                              - Governmental Affairs & Regulatory Law
                              - Intellectual Property & Patent
                              - Labor & Employment
                              - Lawyer / Attorney
                              - Other Legal
                              - Legal Counsel
                              - Legal Operations
                              - Litigation
                              - Privacy
                              - Marketing
                              - Advertising
                              - Brand Management
                              - Content Marketing
                              - Customer Experience
                              - Customer Marketing
                              - Growth & Demand Generation
                              - Digital Marketing
                              - eCommerce Marketing
                              - Event & Field Marketing
                              - Lead Generation
                              - Marketing Operations
                              - Product Marketing
                              - Public Relations
                              - SEO
                              - Social Media Marketing
                              - Technical Marketing
                              - Medical & Health
                              - Anesthesiology
                              - Chiropractics
                              - Clinical Systems
                              - Dentistry
                              - Dermatology
                              - Doctors / Physicians
                              - Epidemiology
                              - Fire Responder
                              - Infectious Disease
                              - Medical Administration
                              - Medical Education & Training
                              - Clinical Research
                              - Neurology
                              - Nursing
                              - Nutrition & Dietetics
                              - Obstetrics / Gynecology
                              - Oncology
                              - Opthalmology
                              - Optometry
                              - Orthopedics
                              - Radiology
                              - Public Health
                              - Psychology
                              - Psychiatry
                              - Physical Therapy
                              - Pharmacy
                              - Pediatrics
                              - Pathology
                              - Operations
                              - Supply Chain
                              - Store Operations
                              - Safety
                              - Real Estate
                              - Quality Management
                              - Physical Security
                              - Office Operations
                              - Logistics
                              - Leasing
                              - Facilities Management
                              - Customer Service / Support
                              - Corporate Strategy
                              - Construction
                              - Call Center
                              - Sales
                              - Other Sales
                              - Sales Training
                              - Sales Operations
                              - Sales Engineering
                              - Sales Enablement
                              - Revenue Operations
                              - Partnerships
                              - Sales Development
                              - Account Executive
                              - Field / Outside Sales
                              - Customer Success
                              - Customer Retention & Development
                              - Channel Sales
                              - Account Management
                            type: string
                          maxItems: 100
                          description: Canonical values to include.
                      description: >-
                        Canonical departments; include and exclude are mutually
                        exclusive.
                      additionalProperties: false
                    person_job_change:
                      type: object
                      properties:
                        only_promotion:
                          type: boolean
                          description: Return promotions only. GROWTH+ only.
                        timeframe_days:
                          enum:
                            - 30
                            - 60
                            - 90
                            - 180
                            - 270
                            - 365
                          type: integer
                          description: Job-change lookback in days. GROWTH+ only.
                        only_new_company:
                          type: boolean
                          description: Return moves to a new company only. GROWTH+ only.
                      description: >-
                        Recent job-change criteria. GROWTH+ only; lower plans
                        return PLAN_REQUIRED.
                      additionalProperties: false
                    company_attributes:
                      type: object
                      properties:
                        b2b:
                          type: boolean
                          description: Filter by B2B status.
                        demo:
                          type: boolean
                          description: Filter by demo availability.
                        has_api:
                          type: boolean
                          description: Filter by API availability.
                        has_sso:
                          type: boolean
                          description: Filter by SSO availability.
                        pricing:
                          type: boolean
                          description: Filter by public-pricing presence.
                        uses_ai:
                          type: boolean
                          description: Filter by use of AI.
                        has_blog:
                          type: boolean
                          description: Filter by blog presence.
                        has_ccpa:
                          type: boolean
                          description: Filter by CCPA compliance.
                        has_gdpr:
                          type: boolean
                          description: Filter by GDPR compliance.
                        has_soc2:
                          type: boolean
                          description: Filter by SOC 2 compliance.
                        freetrial:
                          type: boolean
                          description: Filter by free-trial availability.
                        has_hipaa:
                          type: boolean
                          description: Filter by HIPAA compliance.
                        mobileapps:
                          type: boolean
                          description: Filter by mobile-app availability.
                        has_academy:
                          type: boolean
                          description: Filter by academy presence.
                        has_pci_dss:
                          type: boolean
                          description: Filter by PCI DSS compliance.
                        has_podcast:
                          type: boolean
                          description: Filter by podcast presence.
                        downloadable:
                          type: boolean
                          description: Filter by downloadable products.
                        has_iso27001:
                          type: boolean
                          description: Filter by ISO 27001 compliance.
                        onlinereviews:
                          type: boolean
                          description: Filter by online-review presence.
                        data_residency:
                          type: string
                          description: Required data-residency location.
                        has_esg_reports:
                          type: boolean
                          description: Filter by ESG-report availability.
                        has_marketplace:
                          type: boolean
                          description: Filter by marketplace presence.
                        has_open_source:
                          type: boolean
                          description: Filter by open-source offering.
                        has_case_studies:
                          type: boolean
                          description: Filter by case-study presence.
                        has_chat_support:
                          type: boolean
                          description: Filter by chat support.
                        has_testimonials:
                          type: boolean
                          description: Filter by testimonial presence.
                        other_compliance:
                          type: array
                          items:
                            type: string
                          maxItems: 50
                          description: Other compliance standards, up to 50.
                        has_email_support:
                          type: boolean
                          description: Filter by email support.
                        has_phone_support:
                          type: boolean
                          description: Filter by phone support.
                        is_venture_backed:
                          type: boolean
                          description: Filter by venture-backed status.
                        has_knowledge_base:
                          type: boolean
                          description: Filter by knowledge-base presence.
                        has_social_support:
                          type: boolean
                          description: Filter by social-media support.
                        has_ticket_support:
                          type: boolean
                          description: Filter by ticket support.
                        is_publicly_traded:
                          type: boolean
                          description: Filter by public-company status.
                        has_community_forum:
                          type: boolean
                          description: Filter by community forum presence.
                        has_chrome_extension:
                          type: boolean
                          description: Filter by Chrome extension availability.
                        has_physical_offices:
                          type: boolean
                          description: Filter by physical-office presence.
                        has_uptime_guarantee:
                          type: boolean
                          description: Filter by uptime guarantee.
                        compliance_match_mode:
                          enum:
                            - EXACT
                            - CONTAINS
                          type: string
                          description: How other compliance values are matched.
                        has_affiliate_program:
                          type: boolean
                          description: Filter by affiliate-program presence.
                      description: >-
                        Explicit company product, support, compliance, and
                        status attributes.
                      additionalProperties: false
                    company_technology:
                      type: object
                      properties:
                        exclude:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: Values to exclude, up to 20.
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: Values to include, up to 20.
                      description: >-
                        Canonical technologies, up to 20 per list. STARTER+
                        only; FREE was verified to return PLAN_REQUIRED.
                      additionalProperties: false
                    person_past_company:
                      type: object
                      required:
                        - company_oids
                      properties:
                        company_oids:
                          type: array
                          items:
                            type: string
                          maxItems: 100
                          minItems: 1
                          description: Past Prospeo company IDs, 1-100. GROWTH+ only.
                        combine_with_current:
                          enum:
                            - OR
                            - AND
                          type: string
                          description: >-
                            How past and current companies combine. GROWTH+
                            only.
                      description: >-
                        Past company criteria. GROWTH+ only; lower plans return
                        PLAN_REQUIRED.
                      additionalProperties: false
                    company_integrations:
                      type: object
                      properties:
                        exclude:
                          type: array
                          items:
                            type: string
                          maxItems: 10
                          description: >-
                            Integrations to exclude, up to 10; requires include.
                            GROWTH+ only.
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: Integrations to include, up to 20. GROWTH+ only.
                      description: >-
                        Integration criteria. GROWTH+ only; lower plans return
                        PLAN_REQUIRED.
                      additionalProperties: false
                    company_key_customers:
                      type: object
                      required:
                        - include
                      properties:
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 100
                          minItems: 1
                          description: Required values, 1-100.
                      description: >-
                        Key customer names. GROWTH+ only; lower plans return
                        PLAN_REQUIRED.
                      additionalProperties: false
                    person_past_job_title:
                      type: object
                      required:
                        - include
                      properties:
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 50
                          minItems: 1
                          description: Past job titles, 1-50. GROWTH+ only.
                        match_mode:
                          enum:
                            - EXACT
                            - CONTAINS
                          type: string
                          description: Past-title match mode. GROWTH+ only.
                        titles_logic:
                          enum:
                            - OR
                            - AND
                          type: string
                          description: How past titles combine. GROWTH+ only.
                        combine_with_current:
                          enum:
                            - OR
                            - AND
                          type: string
                          description: How past and current titles combine. GROWTH+ only.
                      description: >-
                        Past title criteria. GROWTH+ only; lower plans return
                        PLAN_REQUIRED.
                      additionalProperties: false
                    company_email_provider:
                      type: array
                      items:
                        enum:
                          - Microsoft
                          - Google
                          - Proofpoint
                          - Mimecast
                          - Other
                        type: string
                      description: Company email infrastructure providers.
                    company_website_search:
                      type: object
                      properties:
                        search_in:
                          type: object
                          properties:
                            page_body:
                              type: boolean
                              description: Search page body text. PRO+ only.
                            urls_only:
                              type: boolean
                              description: Search URLs only. PRO+ only.
                            page_titles:
                              type: boolean
                              description: Search page titles. PRO+ only.
                            headings_only:
                              type: boolean
                              description: Search headings only. PRO+ only.
                            seo_description:
                              type: boolean
                              description: Search SEO descriptions. PRO+ only.
                          description: Website areas to search. PRO+ only.
                          additionalProperties: false
                        match_mode:
                          enum:
                            - any
                            - all
                          type: string
                          description: Website keyword match mode. PRO+ only.
                        page_scope:
                          type: array
                          items:
                            enum:
                              - homepage
                              - product
                              - blog
                              - careers
                              - about
                            type: string
                          maxItems: 5
                          description: Page scopes, up to 5. PRO+ only.
                        has_sla_page:
                          type: boolean
                          description: Filter by SLA page. PRO+ only.
                        url_contains:
                          type: string
                          description: Required URL substring. PRO+ only.
                        has_status_page:
                          type: boolean
                          description: Filter by status page. PRO+ only.
                        exclude_keywords:
                          type: array
                          items:
                            type: string
                          maxItems: 10
                          description: Website keywords to exclude, up to 10. PRO+ only.
                        has_careers_page:
                          type: boolean
                          description: Filter by careers page. PRO+ only.
                        include_keywords:
                          type: array
                          items:
                            type: string
                          maxItems: 10
                          description: Website keywords to include, up to 10. PRO+ only.
                        has_investor_page:
                          type: boolean
                          description: Filter by investor page. PRO+ only.
                        has_persona_pages:
                          type: boolean
                          description: Filter by persona pages. PRO+ only.
                        has_security_page:
                          type: boolean
                          description: Filter by security page. PRO+ only.
                        has_industry_pages:
                          type: boolean
                          description: Filter by industry pages. PRO+ only.
                        has_solution_pages:
                          type: boolean
                          description: Filter by solution pages. PRO+ only.
                        has_comparison_pages:
                          type: boolean
                          description: Filter by comparison pages. PRO+ only.
                        has_developer_docs_page:
                          type: boolean
                          description: Filter by developer docs. PRO+ only.
                      description: >-
                        Website-content criteria. PRO+ only; lower plans return
                        PLAN_REQUIRED.
                      additionalProperties: false
                    max_person_per_company:
                      type: integer
                      maximum: 100
                      minimum: 1
                      description: Maximum people returned per company, 1-100.
                    person_contact_details:
                      type: object
                      properties:
                        email:
                          type: array
                          items:
                            type: string
                            const: VERIFIED
                          description: >-
                            Require verified email availability; values are not
                            revealed by search.
                        mobile:
                          type: array
                          items:
                            enum:
                              - VERIFIED
                              - UNAVAILABLE
                            type: string
                          description: >-
                            Filter mobile availability; values are not revealed
                            by search.
                        operator:
                          enum:
                            - OR
                            - AND
                          type: string
                          description: How email and mobile conditions combine.
                        hide_people_with_details_already_revealed:
                          type: boolean
                          description: >-
                            Hide people whose contact details the team already
                            revealed.
                      description: >-
                        Contact availability only; search never reveals email or
                        mobile values.
                      additionalProperties: false
                    person_location_search:
                      type: object
                      properties:
                        exclude:
                          type: array
                          items:
                            type: string
                          maxItems: 100
                          description: Values to exclude, up to 100.
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 100
                          description: Values to include, up to 100.
                      description: >-
                        Canonical locations from SEARCH_SUGGESTIONS, up to 100
                        include and exclude values.
                      additionalProperties: false
                    company_headcount_range:
                      type: array
                      items:
                        enum:
                          - 1-10
                          - 11-20
                          - 21-50
                          - 51-100
                          - 101-200
                          - 201-500
                          - 501-1000
                          - 1001-2000
                          - 2001-5000
                          - 5001-10000
                          - 10000+
                        type: string
                      description: >-
                        Canonical employee ranges; cannot combine with
                        company_headcount_custom.
                    company_location_search:
                      type: object
                      properties:
                        exclude:
                          type: array
                          items:
                            type: string
                          maxItems: 100
                          description: Values to exclude, up to 100.
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 100
                          description: Values to include, up to 100.
                      description: >-
                        Canonical company locations, up to 100 include and
                        exclude values.
                      additionalProperties: false
                    company_website_traffic:
                      type: object
                      properties:
                        visit_change:
                          type: object
                          properties:
                            period:
                              enum:
                                - monthly
                                - quarterly
                                - yearly
                              type: string
                              description: Traffic-change period. PRO+ only.
                            max_change:
                              type: number
                              maximum: 10000
                              minimum: -100
                              description: Maximum traffic change. PRO+ only.
                            min_change:
                              type: number
                              maximum: 10000
                              minimum: -100
                              description: Minimum traffic change. PRO+ only.
                          description: Traffic-change range. PRO+ only.
                          additionalProperties: false
                        top_countries:
                          type: array
                          items:
                            type: string
                          maxItems: 5
                          minItems: 1
                          description: Top visitor countries, 1-5. PRO+ only.
                        max_country_pct:
                          type: number
                          maximum: 100
                          minimum: 0
                          description: Maximum country traffic percentage. PRO+ only.
                        min_country_pct:
                          type: number
                          maximum: 100
                          minimum: 0
                          description: Minimum country traffic percentage. PRO+ only.
                        max_monthly_visits:
                          type: integer
                          maximum: 100000000
                          minimum: 0
                          description: Maximum monthly visits. PRO+ only.
                        min_monthly_visits:
                          type: integer
                          maximum: 100000000
                          minimum: 0
                          description: Minimum monthly visits. PRO+ only.
                      description: >-
                        Website traffic criteria. PRO+ only; lower plans return
                        PLAN_REQUIRED.
                      additionalProperties: false
                    company_google_discovery:
                      type: object
                      required:
                        - seo_keywords
                      properties:
                        seo_keywords:
                          type: array
                          items:
                            type: string
                          maxItems: 100
                          minItems: 1
                          description: SEO keywords, 1-100. PRO+ only.
                      description: >-
                        Google SEO discovery. PRO+ only; lower plans return
                        PLAN_REQUIRED.
                      additionalProperties: false
                    company_headcount_custom:
                      type: object
                      properties:
                        max:
                          type: integer
                          maximum: 999999
                          minimum: 1
                          description: Inclusive maximum employee count.
                        min:
                          type: integer
                          maximum: 999998
                          minimum: 1
                          description: Inclusive minimum employee count.
                      description: >-
                        Custom employee-count range; cannot combine with
                        company_headcount_range.
                      additionalProperties: false
                    company_headcount_growth:
                      type: object
                      properties:
                        max:
                          type: integer
                          maximum: 10000
                          minimum: -100
                          description: Maximum headcount growth percentage.
                        min:
                          type: integer
                          maximum: 10000
                          minimum: -100
                          description: Minimum headcount growth percentage.
                        departments:
                          type: array
                          items:
                            enum:
                              - Administrative
                              - Consulting
                              - Customer service
                              - Design / UI / UX
                              - Education
                              - Finance
                              - General management
                              - HR
                              - Legal
                              - Marketing
                              - Medical
                              - Operations
                              - Product
                              - Project management
                              - Real estate
                              - Research
                              - Sales
                              - Technical
                              - Trades
                            type: string
                          maxItems: 10
                          description: Canonical departments, up to 10.
                        timeframe_month:
                          enum:
                            - 3
                            - 6
                            - 12
                            - 24
                          type: integer
                          description: Growth measurement window in months.
                      description: Headcount-growth criteria.
                      additionalProperties: false
                    person_name_or_job_title:
                      type: string
                      minLength: 1
                      description: >-
                        Free-text quick search across person name and current
                        job title.
                    company_products_services:
                      type: object
                      properties:
                        products_exclude:
                          type: array
                          items:
                            type: string
                          maxItems: 10
                          description: >-
                            Products to exclude, up to 10; requires
                            products_include.
                        products_include:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: Products to include, up to 20.
                        products_match_all:
                          type: boolean
                          description: Require all included products.
                        service_tags_exclude:
                          type: array
                          items:
                            type: string
                          maxItems: 10
                          description: >-
                            Service tags to exclude, up to 10; requires
                            service_tags_include.
                        service_tags_include:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: Service tags to include, up to 20.
                        service_tags_match_all:
                          type: boolean
                          description: Require all included service tags.
                      description: Products and services criteria.
                      additionalProperties: false
                    person_year_of_experience:
                      type: object
                      properties:
                        max:
                          type: integer
                          maximum: 60
                          minimum: 1
                          description: Maximum years of experience.
                        min:
                          type: integer
                          maximum: 60
                          minimum: 0
                          description: Minimum years of experience.
                      description: Total years-of-experience range.
                      additionalProperties: false
                    company_operating_languages:
                      type: object
                      required:
                        - include
                      properties:
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 10
                          minItems: 1
                          description: Operating languages to include, 1-10.
                      description: >-
                        Filter companies by languages they operate in; use
                        Search Filter Suggestions to resolve canonical language
                        values.
                      additionalProperties: false
                    person_time_in_current_role:
                      type: object
                      properties:
                        max:
                          type: integer
                          maximum: 600
                          minimum: 0
                          description: Maximum number of months.
                        min:
                          type: integer
                          maximum: 600
                          minimum: 0
                          description: Minimum number of months.
                      description: Months in current role.
                      additionalProperties: false
                    company_job_posting_quantity:
                      type: object
                      properties:
                        max:
                          type: integer
                          maximum: 5000
                          minimum: 0
                          description: Maximum active postings. STARTER+ only.
                        min:
                          type: integer
                          maximum: 5000
                          minimum: 0
                          description: Minimum active postings. STARTER+ only.
                      description: >-
                        Active job-posting count. STARTER+ only; lower plans
                        return PLAN_REQUIRED.
                      additionalProperties: false
                    person_awards_certifications:
                      type: object
                      properties:
                        awards:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: Award names, up to 20. GROWTH+ only.
                        award_issuers:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: Award issuers, up to 20. GROWTH+ only.
                        award_year_max:
                          type: integer
                          minimum: 1900
                          description: >-
                            Latest award year; requires an award or issuer.
                            GROWTH+ only.
                        award_year_min:
                          type: integer
                          minimum: 1900
                          description: >-
                            Earliest award year; requires an award or issuer.
                            GROWTH+ only.
                        certifications:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: Certification names, up to 20. GROWTH+ only.
                        certification_issuers:
                          type: array
                          items:
                            type: string
                          maxItems: 20
                          description: Certification issuers, up to 20. GROWTH+ only.
                        certification_year_max:
                          type: integer
                          minimum: 1900
                          description: >-
                            Latest certification year; requires a certification
                            or issuer. GROWTH+ only.
                        certification_year_min:
                          type: integer
                          minimum: 1900
                          description: >-
                            Earliest certification year; requires a
                            certification or issuer. GROWTH+ only.
                      description: >-
                        Awards and certifications. GROWTH+ only; lower plans
                        return PLAN_REQUIRED.
                      additionalProperties: false
                    company_headcount_by_location:
                      type: object
                      required:
                        - entries
                      properties:
                        entries:
                          type: array
                          items:
                            type: object
                            required:
                              - country
                            properties:
                              country:
                                type: string
                                minLength: 1
                                description: Country name.
                              max_headcount:
                                type: integer
                                maximum: 1000000
                                minimum: 0
                                description: Maximum country headcount.
                              min_headcount:
                                type: integer
                                maximum: 1000000
                                minimum: 0
                                description: Minimum country headcount.
                          maxItems: 10
                          minItems: 1
                          description: Country headcount ranges, 1-10. GROWTH+ only.
                      description: >-
                        Country headcount ranges. GROWTH+ only; lower plans
                        return PLAN_REQUIRED.
                      additionalProperties: false
                    company_job_posting_hiring_for:
                      type: object
                      properties:
                        exclude:
                          type: array
                          items:
                            type: string
                          maxItems: 500
                          description: Job titles to exclude. STARTER+ only.
                        include:
                          type: array
                          items:
                            type: string
                          maxItems: 500
                          description: Job titles to include. STARTER+ only.
                        match_type:
                          enum:
                            - contains
                            - exact
                          type: string
                          description: Job-title match type. STARTER+ only.
                        boolean_search:
                          type: string
                          description: >-
                            Boolean job-title query. STARTER+ only; cannot
                            combine with include or exclude.
                      description: >-
                        Hiring-title criteria. STARTER+ only; lower plans return
                        PLAN_REQUIRED.
                      additionalProperties: false
                    person_time_in_current_company:
                      type: object
                      properties:
                        max:
                          type: integer
                          maximum: 600
                          minimum: 0
                          description: Maximum number of months.
                        min:
                          type: integer
                          maximum: 600
                          minimum: 0
                          description: Minimum number of months.
                      description: Months at current company.
                      additionalProperties: false
                    company_headcount_by_department:
                      type: array
                      items:
                        type: object
                        required:
                          - department
                        properties:
                          max:
                            type: integer
                            maximum: 100000
                            minimum: 0
                            description: Maximum department headcount.
                          min:
                            type: integer
                            maximum: 100000
                            minimum: 0
                            description: Minimum department headcount.
                          department:
                            enum:
                              - C-Suite
                              - Chief Executive
                              - Finance Executive
                              - Founder
                              - Human Resources Executive
                              - Information Technology Executive
                              - Legal Executive
                              - Marketing Executive
                              - Medical & Health Executive
                              - Operations Executive
                              - Sales Leader
                              - Product
                              - Product Development
                              - Product Management
                              - Other Product
                              - Engineering & Technical
                              - Artificial Intelligence / Machine Learning
                              - Bioengineering
                              - Biometrics
                              - Business Intelligence
                              - Chemical Engineering
                              - Data Science & Analysis
                              - DevOps
                              - Digital Transformation
                              - Emerging Technology / Innovation
                              - Industrial Engineering
                              - Mechanic
                              - Mobile Development
                              - Project Management
                              - Research & Development
                              - Scrum Master / Agile Coach
                              - Software Development
                              - Technician
                              - Technology Operations
                              - Test / Quality Assurance
                              - Consulting
                              - Consultant
                              - Design
                              - Other Design
                              - Graphic / Visual / Brand Design
                              - Education & Coaching
                              - Teacher
                              - Superintendent
                              - Professor
                              - Coach / Trainer
                              - Finance
                              - Financial Reporting
                              - Financial Systems
                              - Accounting
                              - Finance & Banking
                              - Financial Planning, Strategy & Analysis
                              - Internal Audit & Control
                              - Investor Relations
                              - Mergers & Acquisitions
                              - Real Estate Finance
                              - Financial Risk
                              - Sourcing / Procurement
                              - Tax
                              - Treasury
                              - Human Resources
                              - Compensation & Benefits
                              - Culture, Diversity & Inclusion
                              - Health & Safety
                              - Other Human Resources
                              - HR Business Partner
                              - Learning & Development
                              - Organizational Development
                              - Recruiting & Talent Acquisition
                              - Talent Management
                              - Workforce Management
                              - People Operations
                              - Information Technology
                              - Cloud Engineering
                              - Data Center
                              - Data Warehouse
                              - Database Administration
                              - eCommerce Development
                              - Help Desk / Desktop Services
                              - Information Security
                              - IT Asset Management
                              - IT Audit / IT Compliance
                              - IT Recruitement
                              - IT Procurement
                              - IT Strategy
                              - IT Training
                              - Networking
                              - Technical Lead
                              - Quality Assurance
                              - Retail / Store Systems
                              - Servers
                              - Disaster Recovery
                              - Telecommunications
                              - Legal
                              - Compliance
                              - Contracts
                              - Corporate Secretary
                              - eDiscovery
                              - Ethics
                              - Governance
                              - Governmental Affairs & Regulatory Law
                              - Intellectual Property & Patent
                              - Labor & Employment
                              - Lawyer / Attorney
                              - Other Legal
                              - Legal Counsel
                              - Legal Operations
                              - Litigation
                              - Privacy
                              - Marketing
                              - Advertising
                              - Brand Management
                              - Content Marketing
                              - Customer Experience
                              - Customer Marketing
                              - Growth & Demand Generation
                              - Digital Marketing
                              - eCommerce Marketing
                              - Event & Field Marketing
                              - Lead Generation
                              - Marketing Operations
                              - Product Marketing
                              - Public Relations
                              - SEO
                              - Social Media Marketing
                              - Technical Marketing
                              - Medical & Health
                              - Anesthesiology
                              - Chiropractics
                              - Clinical Systems
                              - Dentistry
                              - Dermatology
                              - Doctors / Physicians
                              - Epidemiology
                              - Fire Responder
                              - Infectious Disease
                              - Medical Administration
                              - Medical Education & Training
                              - Clinical Research
                              - Neurology
                              - Nursing
                              - Nutrition & Dietetics
                              - Obstetrics / Gynecology
                              - Oncology
                              - Opthalmology
                              - Optometry
                              - Orthopedics
                              - Radiology
                              - Public Health
                              - Psychology
                              - Psychiatry
                              - Physical Therapy
                              - Pharmacy
                              - Pediatrics
                              - Pathology
                              - Operations
                              - Supply Chain
                              - Store Operations
                              - Safety
                              - Real Estate
                              - Quality Management
                              - Physical Security
                              - Office Operations
                              - Logistics
                              - Leasing
                              - Facilities Management
                              - Customer Service / Support
                              - Corporate Strategy
                              - Construction
                              - Call Center
                              - Sales
                              - Other Sales
                              - Sales Training
                              - Sales Operations
                              - Sales Engineering
                              - Sales Enablement
                              - Revenue Operations
                              - Partnerships
                              - Sales Development
                              - Account Executive
                              - Field / Outside Sales
                              - Customer Success
                              - Customer Retention & Development
                              - Channel Sales
                              - Account Management
                            type: string
                            description: Canonical department name.
                      maxItems: 10
                      description: Department-specific headcount ranges, up to 10.
                  description: >-
                    Typed person and company filters. Required on the first page
                    and restored automatically from next_cursor on continuation
                    pages. At least one positive filter is required.
                    Dashboard-only persona_ids, company_list_oids, and
                    temp_matching_oids are not supported.
                  additionalProperties: false
                next_cursor:
                  type: string
                  description: >-
                    Opaque cursor from a prior response. Omit for page one; when
                    provided, omit filters because the cursor restores them and
                    advances one page.
      responses:
        '200':
          description: Tool result data
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__public_data
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
components:
  schemas:
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__public_data:
      $ref: >-
        #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__d0b1defc9b5f64c2
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__d0b1defc9b5f64c2:
      type: object
      properties:
        free:
          type: boolean
        results:
          type: array
          items:
            $ref: >-
              #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__f6b64837eff648ef
        has_more:
          type: boolean
        pagination:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__8511499bd843a247
        next_cursor:
          type: string
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__f6b64837eff648ef:
      type: object
      properties:
        person:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__ad7687d1958bb08d
        company:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__61793974067aa99d
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__8511499bd843a247:
      type: object
      properties:
        per_page:
          type: integer
        total_page:
          type: integer
        total_count:
          type: integer
        current_page:
          type: integer
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__ad7687d1958bb08d:
      type: object
      properties:
        email:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__46e12dbaa37f3fd7
        mobile:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__1b5dc22ab65f9e8e
        skills:
          type: array
          items:
            type: string
        headline:
          type: string
        location:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__39a2e13d856811ec
        full_name:
          type: string
        last_name:
          type: string
        person_id:
          type: string
        first_name:
          type: string
        job_history:
          type: array
          items:
            $ref: >-
              #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__facb8b909af08b1c
        linkedin_url:
          type: string
        current_job_key:
          type: string
        current_job_title:
          type: string
        linkedin_member_id:
          type: string
        last_job_change_detected_at:
          type: string
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__61793974067aa99d:
      type: object
      properties:
        name:
          type: string
        type:
          type: string
        domain:
          type: string
        founded:
          type: integer
        funding:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__41e0a0f43c268af5
        website:
          type: string
        industry:
          type: string
        keywords:
          type: array
          items:
            type: string
        location:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__20b6b1d8f0c1ac14
        logo_url:
          type: string
        phone_hq:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__234a830bb70692ce
        sic_codes:
          type: array
          items:
            type: string
        attributes:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__f000885c57a8bd14
        company_id:
          type: string
        email_tech:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__d2690f4547d1eb4b
        technology:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__9989b36731b61972
        description:
          type: string
        linkedin_id:
          type: string
        naics_codes:
          type: array
          items:
            type: string
        twitter_url:
          type: string
        youtube_url:
          type: string
        facebook_url:
          type: string
        job_postings:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__29f3030b5cbe0625
        linkedin_url:
          type: string
        instagram_url:
          type: string
        revenue_range:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__1b2fe457a98d9bc8
        crunchbase_url:
          type: string
        description_ai:
          type: string
        employee_count:
          type: integer
        employee_range:
          type: string
        other_websites:
          type: array
          items:
            type: string
        description_seo:
          type: string
        revenue_range_printed:
          type: string
        employee_count_on_prospeo:
          type: integer
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__46e12dbaa37f3fd7:
      type: object
      properties:
        email:
          type: string
        status:
          type: string
        revealed:
          type: boolean
        email_mx_provider:
          type: string
        verification_method:
          type: string
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__1b5dc22ab65f9e8e:
      type: object
      properties:
        mobile:
          type: string
        status:
          type: string
        revealed:
          type: boolean
        mobile_country:
          type: string
        mobile_national:
          type: string
        mobile_country_code:
          type: string
        mobile_international:
          type: string
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__39a2e13d856811ec:
      type: object
      properties:
        city:
          type: string
        state:
          type: string
        country:
          type: string
        time_zone:
          type: string
        country_code:
          type: string
        time_zone_offset:
          type: number
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__facb8b909af08b1c:
      type: object
      properties:
        title:
          type: string
        current:
          type: boolean
        job_key:
          type: string
        end_year:
          type: integer
        logo_url:
          type: string
        end_month:
          type: integer
        seniority:
          type: string
        company_id:
          type: string
        start_year:
          type: integer
        departments:
          type: array
          items:
            type: string
        start_month:
          type: integer
        company_name:
          type: string
        duration_in_months:
          type: integer
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__41e0a0f43c268af5:
      type: object
      properties:
        count:
          type: integer
        total_funding:
          anyOf:
            - type: integer
            - type: number
        funding_events:
          type: array
          items:
            $ref: >-
              #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__9ede638bbb5ca149
        latest_funding_date:
          type: string
        latest_funding_stage:
          type: string
        total_funding_printed:
          type: string
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__20b6b1d8f0c1ac14:
      type: object
      properties:
        city:
          type: string
        state:
          type: string
        country:
          type: string
        raw_address:
          type: string
        country_code:
          type: string
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__234a830bb70692ce:
      type: object
      properties:
        phone_hq:
          type: string
        phone_hq_country:
          type: string
        phone_hq_national:
          type: string
        phone_hq_country_code:
          type: string
        phone_hq_international:
          type: string
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__f000885c57a8bd14:
      type: object
      properties:
        is_b2b:
          type: boolean
        has_demo:
          type: boolean
        has_pricing:
          type: boolean
        has_free_trial:
          type: boolean
        has_mobile_apps:
          type: boolean
        has_downloadable:
          type: boolean
        has_online_reviews:
          type: boolean
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__d2690f4547d1eb4b:
      type: object
      properties:
        domain:
          type: string
        mx_provider:
          type: string
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__9989b36731b61972:
      type: object
      properties:
        count:
          type: integer
        technology_list:
          type: array
          items:
            $ref: >-
              #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__5894a3348346eadb
        technology_names:
          type: array
          items:
            type: string
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__29f3030b5cbe0625:
      type: object
      properties:
        active_count:
          type: integer
        active_titles:
          type: array
          items:
            type: string
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__1b2fe457a98d9bc8:
      type: object
      properties:
        max:
          anyOf:
            - type: integer
            - type: number
        min:
          anyOf:
            - type: integer
            - type: number
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__9ede638bbb5ca149:
      type: object
      properties:
        link:
          type: string
        stage:
          type: string
        amount:
          anyOf:
            - type: integer
            - type: number
        raised_at:
          type: string
        amount_printed:
          type: string
    Response576A0Ea506F3_connect_PROSPEO_SEARCH_PEOPLE__output__5894a3348346eadb:
      type: object
      properties:
        name:
          type: string
        category:
          type: string
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.