> ## 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 Companies > Usage-based billing; Default request estimate: $0.0243 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** POST /apis/v1/prospeo/search-companies * **Availability:** enabled * **Request URL template:** `https://api.aisa.one/apis/v1/prospeo/search-companies` * **Runtime facts:** 14747b6d3b7c1fb8f4ed610011f8f5654aa07f8d884665f33860fa90664909fa [Complete OpenAPI definition](https://aisa.one/docs/reference-contracts/prospeo.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "prospeo.search-companies", "method": "POST", "path": "/apis/v1/prospeo/search-companies", "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." }, "include": { "type": "array", "items": { "type": "string" }, "maxItems": 500, "description": "Values to include." } }, "description": "Company names to include or exclude (up to 500 each).", "additionalProperties": false }, "websites": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string" }, "maxItems": 500, "description": "Values to exclude." }, "include": { "type": "array", "items": { "type": "string" }, "maxItems": 500, "description": "Values to include." } }, "description": "Root company websites or domains to include or exclude (up to 500 each).", "additionalProperties": false } }, "description": "Company names or root websites. Company IDs are not valid for company search.", "additionalProperties": false }, "company_icp": { "type": "object", "properties": { "industries": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "GROWTH+ ICP industries." }, "departments": { "type": "object", "properties": { "other": { "type": "array", "items": { "type": "string" }, "maxItems": 5, "description": "GROWTH+ other departments (up to 5)." }, "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": "GROWTH+ canonical departments to include." }, "match_mode": { "enum": [ "any", "all" ], "type": "string", "description": "GROWTH+ department matching mode." } }, "description": "GROWTH+ ICP departments.", "additionalProperties": false }, "company_sizes": { "type": "array", "items": { "enum": [ "micro", "smb", "midmarket", "enterprise", "large_enterprise" ], "type": "string" }, "description": "GROWTH+ ICP company sizes." }, "titles_exclude": { "type": "array", "items": { "type": "string" }, "maxItems": 20, "description": "GROWTH+ ICP titles to exclude." }, "titles_include": { "type": "array", "items": { "type": "string" }, "maxItems": 20, "description": "GROWTH+ ICP titles to include." }, "geographic_scope": { "enum": [ "single_country", "multi_country" ], "type": "string", "description": "GROWTH+ ICP geographic scope." }, "geographic_markets": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "GROWTH+ ICP geographic markets." } }, "description": "GROWTH+ ideal-customer-profile filters.", "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 in days." } }, "description": "Company news keywords or categories.", "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 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": "CompanySubtypeFilters", "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 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 offering." } } }, { "enum": [ "Private", "Public", "Non Profit", "Other" ], "type": "string" } ], "description": "FREE company status or detailed company-type facets." }, "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 suggestions.", "additionalProperties": false }, "company_awards": { "type": "object", "required": [ "include" ], "properties": { "include": { "type": "array", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "description": "GROWTH+ awards to include (1-50)." }, "match_mode": { "enum": [ "EXACT", "CONTAINS" ], "type": "string", "description": "GROWTH+ award matching mode." } }, "description": "GROWTH+ company award filters.", "additionalProperties": false }, "company_intent": { "type": "object", "required": [ "topic_ids" ], "properties": { "topic_ids": { "type": "array", "items": { "type": "string" }, "maxItems": 30, "minItems": 1, "description": "Account-specific Prospeo dashboard topic IDs (1-30)." }, "early_research": { "type": "boolean", "description": "Filter early research intent." }, "active_research": { "type": "boolean", "description": "Filter active research intent." }, "in_depth_research": { "type": "boolean", "description": "Filter in-depth research intent." } }, "description": "Account-specific intent topics from the Prospeo dashboard.", "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": "Company founding-year filters.", "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": "STARTER+ funding stages (up to 500)." }, "investors": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "STARTER+ investors (up to 10)." }, "funding_date": { "enum": [ 30, 60, 90, 180, 270, 365 ], "type": "integer", "description": "STARTER+ latest-funding lookback in days." }, "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": "STARTER+ latest funding amount range.", "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": "STARTER+ total funding amount range.", "additionalProperties": false }, "accelerator_name": { "type": "string", "description": "STARTER+ accelerator name." }, "was_in_accelerator": { "type": "boolean", "description": "STARTER+: filter by accelerator participation." } }, "description": "STARTER+ funding filters; 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": "STARTER+ maximum revenue band." }, "min": { "enum": [ "<100K", "100K", "500K", "1M", "5M", "10M", "25M", "50M", "100M", "250M", "500M", "1B", "5B", "10B+" ], "type": "string", "description": "STARTER+ minimum revenue band." }, "include_unknown_revenue": { "type": "boolean", "description": "STARTER+: include companies with unknown revenue." } }, "description": "STARTER+ revenue filters; FREE returns PLAN_REQUIRED.", "additionalProperties": false }, "company_industry": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string" }, "maxItems": 500, "description": "Values to exclude." }, "include": { "type": "array", "items": { "type": "string" }, "maxItems": 500, "description": "Values to include." } }, "description": "Canonical industries to include or exclude.", "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)." }, "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 when true." }, "search_everywhere": { "type": "boolean", "description": "Search all supported company text sources." } }, "description": "Company keyword search.", "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": "PRO+ executive event types (1-10)." }, "timeframe_days": { "enum": [ 60, 90, 180, 365 ], "type": "integer", "description": "PRO+ event lookback in days." } }, "description": "PRO+ key-executive events.", "additionalProperties": false }, "company_lookalike": { "type": "object", "properties": { "domain": { "type": "string", "description": "STARTER+ seed company domain." }, "icp_text": { "type": "string", "maxLength": 5000, "description": "STARTER+ ideal-customer-profile seed text." }, "match_all": { "type": "boolean", "description": "STARTER+: require all lookalike criteria." }, "company_oids": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "STARTER+ seed company IDs (up to 10)." }, "minimum_tier": { "enum": [ "T1", "T2", "T3" ], "type": "string", "description": "STARTER+ minimum similarity tier." }, "same_language": { "type": "boolean", "description": "STARTER+: prefer the seed company's language." } }, "description": "STARTER+ lookalike search. Person IDs are not valid for company search.", "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 detected AI usage." }, "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 value." }, "has_esg_reports": { "type": "boolean", "description": "Filter by ESG-report presence." }, "has_marketplace": { "type": "boolean", "description": "Filter by marketplace presence." }, "has_open_source": { "type": "boolean", "description": "Filter by open-source offerings." }, "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 labels (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 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 guarantees." }, "compliance_match_mode": { "enum": [ "EXACT", "CONTAINS" ], "type": "string", "description": "How to match other_compliance labels." }, "has_affiliate_program": { "type": "boolean", "description": "Filter by affiliate-program presence." } }, "description": "Explicit company capability, compliance, and business attributes.", "additionalProperties": false }, "company_technology": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string" }, "maxItems": 20, "description": "STARTER+ canonical technologies to exclude (up to 20)." }, "include": { "type": "array", "items": { "type": "string" }, "maxItems": 20, "description": "STARTER+ canonical technologies to include (up to 20)." } }, "description": "STARTER+ technologies; FREE returns PLAN_REQUIRED.", "additionalProperties": false }, "company_integrations": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "GROWTH+ integrations to exclude (up to 10)." }, "include": { "type": "array", "items": { "type": "string" }, "maxItems": 20, "description": "GROWTH+ integrations to include (up to 20)." } }, "description": "GROWTH+ integration filters.", "additionalProperties": false }, "company_key_customers": { "type": "object", "required": [ "include" ], "properties": { "include": { "type": "array", "items": { "type": "string" }, "maxItems": 100, "minItems": 1, "description": "GROWTH+ customer names to include (1-100)." } }, "description": "GROWTH+ key-customer filters.", "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." }, "urls_only": { "type": "boolean", "description": "Search URLs only." }, "page_titles": { "type": "boolean", "description": "Search page titles." }, "headings_only": { "type": "boolean", "description": "Search headings only." }, "seo_description": { "type": "boolean", "description": "Search SEO descriptions." } }, "description": "PRO+ website areas to search.", "additionalProperties": false }, "match_mode": { "enum": [ "any", "all" ], "type": "string", "description": "PRO+ keyword matching mode." }, "page_scope": { "type": "array", "items": { "enum": [ "homepage", "product", "blog", "careers", "about" ], "type": "string" }, "maxItems": 5, "description": "PRO+ page types to search." }, "has_sla_page": { "type": "boolean", "description": "PRO+ filter by SLA-page presence." }, "url_contains": { "type": "string", "description": "PRO+ URL substring." }, "has_status_page": { "type": "boolean", "description": "PRO+ filter by status-page presence." }, "exclude_keywords": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "PRO+ website keywords to exclude." }, "has_careers_page": { "type": "boolean", "description": "PRO+ filter by careers-page presence." }, "include_keywords": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "PRO+ website keywords to include." }, "has_investor_page": { "type": "boolean", "description": "PRO+ filter by investor-page presence." }, "has_persona_pages": { "type": "boolean", "description": "PRO+ filter by persona-page presence." }, "has_security_page": { "type": "boolean", "description": "PRO+ filter by security-page presence." }, "has_industry_pages": { "type": "boolean", "description": "PRO+ filter by industry-page presence." }, "has_solution_pages": { "type": "boolean", "description": "PRO+ filter by solution-page presence." }, "has_comparison_pages": { "type": "boolean", "description": "PRO+ filter by comparison-page presence." }, "has_developer_docs_page": { "type": "boolean", "description": "PRO+ filter by developer-docs presence." } }, "description": "PRO+ website-content and page-presence filters.", "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; mutually exclusive with company_headcount_custom." }, "company_location_search": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string" }, "maxItems": 100, "description": "Canonical locations to exclude. Resolve values with Search Filter Suggestions." }, "include": { "type": "array", "items": { "type": "string" }, "maxItems": 100, "description": "Canonical locations to include. Resolve values with Search Filter Suggestions." } }, "description": "Canonical company locations.", "additionalProperties": false }, "company_website_traffic": { "type": "object", "properties": { "visit_change": { "type": "object", "properties": { "period": { "enum": [ "monthly", "quarterly", "yearly" ], "type": "string", "description": "Traffic-change period." }, "max_change": { "type": "number", "maximum": 10000, "minimum": -100, "description": "Maximum visit change." }, "min_change": { "type": "number", "maximum": 10000, "minimum": -100, "description": "Minimum visit change." } }, "description": "PRO+ visit-change range.", "additionalProperties": false }, "top_countries": { "type": "array", "items": { "type": "string" }, "maxItems": 5, "minItems": 1, "description": "PRO+ top traffic countries (1-5)." }, "max_country_pct": { "type": "number", "maximum": 100, "minimum": 0, "description": "PRO+ maximum country traffic percentage." }, "min_country_pct": { "type": "number", "maximum": 100, "minimum": 0, "description": "PRO+ minimum country traffic percentage." }, "max_monthly_visits": { "type": "integer", "maximum": 100000000, "minimum": 0, "description": "PRO+ maximum monthly visits." }, "min_monthly_visits": { "type": "integer", "maximum": 100000000, "minimum": 0, "description": "PRO+ minimum monthly visits." } }, "description": "PRO+ website traffic filters.", "additionalProperties": false }, "company_google_discovery": { "type": "object", "required": [ "seo_keywords" ], "properties": { "seo_keywords": { "type": "array", "items": { "type": "string" }, "maxItems": 100, "minItems": 1, "description": "PRO+ SEO discovery keywords (1-100)." } }, "description": "PRO+ Google discovery filters.", "additionalProperties": false }, "company_headcount_custom": { "type": "object", "properties": { "max": { "type": "integer", "maximum": 999999, "minimum": 1, "description": "Inclusive maximum employees." }, "min": { "type": "integer", "maximum": 999998, "minimum": 1, "description": "Inclusive minimum employees." } }, "description": "Custom employee-count range; mutually exclusive 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 to measure (up to 10)." }, "timeframe_month": { "enum": [ 3, 6, 12, 24 ], "type": "integer", "description": "Growth measurement period in months." } }, "description": "Headcount-growth filters.", "additionalProperties": false }, "company_products_services": { "type": "object", "properties": { "products_exclude": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "Products to exclude (up to 10)." }, "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)." }, "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 filters.", "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 }, "company_job_posting_quantity": { "type": "object", "properties": { "max": { "type": "integer", "maximum": 5000, "minimum": 0, "description": "STARTER+ maximum active job postings." }, "min": { "type": "integer", "maximum": 5000, "minimum": 0, "description": "STARTER+ minimum active job postings." } }, "description": "STARTER+ active job-posting count.", "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 headcount in the country." }, "min_headcount": { "type": "integer", "maximum": 1000000, "minimum": 0, "description": "Minimum headcount in the country." } } }, "maxItems": 10, "minItems": 1, "description": "GROWTH+ country headcount entries (1-10)." } }, "description": "GROWTH+ country headcount filters.", "additionalProperties": false }, "company_job_posting_hiring_for": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string" }, "maxItems": 500, "description": "STARTER+ job titles to exclude." }, "include": { "type": "array", "items": { "type": "string" }, "maxItems": 500, "description": "STARTER+ job titles to include." }, "match_type": { "enum": [ "contains", "exact" ], "type": "string", "description": "STARTER+ title matching mode." }, "boolean_search": { "type": "string", "description": "STARTER+ boolean title expression." } }, "description": "STARTER+ hiring-title filters.", "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 headcount ranges (up to 10)." } }, "description": "Typed company filters. Required on the first page and restored automatically from next_cursor on continuation pages.", "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." } } } } } }, "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" } } } } ``` ## Cost and request rules Usage-based billing; Default request estimate: \$0.0243 USD (not a fixed price). Declared unit rate: \$0.000001 USD per provider\_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.0243 * **Declared unit rate (USD):** 1e-06 * **Billing unit:** provider\_credit * **Cost contract:** response\_units * **Published reference multiplier:** 1.0 * **Declared maximum count/units:** 10000000 * **Settlement evidence source:** response\_body ## OpenAPI ````yaml reference-contracts/prospeo.json POST /apis/v1/prospeo/search-companies 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-companies: post: tags: - Prospeo summary: Search Companies description: >- Usage-based billing; Default request estimate: $0.0243 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. operationId: prospeo.search-companies 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. include: type: array items: type: string maxItems: 500 description: Values to include. description: >- Company names to include or exclude (up to 500 each). additionalProperties: false websites: type: object properties: exclude: type: array items: type: string maxItems: 500 description: Values to exclude. include: type: array items: type: string maxItems: 500 description: Values to include. description: >- Root company websites or domains to include or exclude (up to 500 each). additionalProperties: false description: >- Company names or root websites. Company IDs are not valid for company search. additionalProperties: false company_icp: type: object properties: industries: type: array items: type: string maxItems: 10 description: GROWTH+ ICP industries. departments: type: object properties: other: type: array items: type: string maxItems: 5 description: GROWTH+ other departments (up to 5). 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: GROWTH+ canonical departments to include. match_mode: enum: - any - all type: string description: GROWTH+ department matching mode. description: GROWTH+ ICP departments. additionalProperties: false company_sizes: type: array items: enum: - micro - smb - midmarket - enterprise - large_enterprise type: string description: GROWTH+ ICP company sizes. titles_exclude: type: array items: type: string maxItems: 20 description: GROWTH+ ICP titles to exclude. titles_include: type: array items: type: string maxItems: 20 description: GROWTH+ ICP titles to include. geographic_scope: enum: - single_country - multi_country type: string description: GROWTH+ ICP geographic scope. geographic_markets: type: array items: type: string maxItems: 10 description: GROWTH+ ICP geographic markets. description: GROWTH+ ideal-customer-profile filters. 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 in days. description: Company news keywords or categories. 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 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: CompanySubtypeFilters 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 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 offering. - enum: - Private - Public - Non Profit - Other type: string description: FREE company status or detailed company-type facets. 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 suggestions. additionalProperties: false company_awards: type: object required: - include properties: include: type: array items: type: string maxItems: 50 minItems: 1 description: GROWTH+ awards to include (1-50). match_mode: enum: - EXACT - CONTAINS type: string description: GROWTH+ award matching mode. description: GROWTH+ company award filters. additionalProperties: false company_intent: type: object required: - topic_ids properties: topic_ids: type: array items: type: string maxItems: 30 minItems: 1 description: Account-specific Prospeo dashboard topic IDs (1-30). early_research: type: boolean description: Filter early research intent. active_research: type: boolean description: Filter active research intent. in_depth_research: type: boolean description: Filter in-depth research intent. description: >- Account-specific intent topics from the Prospeo dashboard. 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: Company founding-year filters. 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: STARTER+ funding stages (up to 500). investors: type: array items: type: string maxItems: 10 description: STARTER+ investors (up to 10). funding_date: enum: - 30 - 60 - 90 - 180 - 270 - 365 type: integer description: STARTER+ latest-funding lookback in days. 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: STARTER+ latest funding amount range. 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: STARTER+ total funding amount range. additionalProperties: false accelerator_name: type: string description: STARTER+ accelerator name. was_in_accelerator: type: boolean description: 'STARTER+: filter by accelerator participation.' description: STARTER+ funding filters; 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: STARTER+ maximum revenue band. min: enum: - <100K - 100K - 500K - 1M - 5M - 10M - 25M - 50M - 100M - 250M - 500M - 1B - 5B - 10B+ type: string description: STARTER+ minimum revenue band. include_unknown_revenue: type: boolean description: 'STARTER+: include companies with unknown revenue.' description: STARTER+ revenue filters; FREE returns PLAN_REQUIRED. additionalProperties: false company_industry: type: object properties: exclude: type: array items: type: string maxItems: 500 description: Values to exclude. include: type: array items: type: string maxItems: 500 description: Values to include. description: Canonical industries to include or exclude. 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). 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 when true. search_everywhere: type: boolean description: Search all supported company text sources. description: Company keyword search. 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: PRO+ executive event types (1-10). timeframe_days: enum: - 60 - 90 - 180 - 365 type: integer description: PRO+ event lookback in days. description: PRO+ key-executive events. additionalProperties: false company_lookalike: type: object properties: domain: type: string description: STARTER+ seed company domain. icp_text: type: string maxLength: 5000 description: STARTER+ ideal-customer-profile seed text. match_all: type: boolean description: 'STARTER+: require all lookalike criteria.' company_oids: type: array items: type: string maxItems: 10 description: STARTER+ seed company IDs (up to 10). minimum_tier: enum: - T1 - T2 - T3 type: string description: STARTER+ minimum similarity tier. same_language: type: boolean description: 'STARTER+: prefer the seed company''s language.' description: >- STARTER+ lookalike search. Person IDs are not valid for company search. 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 detected AI usage. 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 value. has_esg_reports: type: boolean description: Filter by ESG-report presence. has_marketplace: type: boolean description: Filter by marketplace presence. has_open_source: type: boolean description: Filter by open-source offerings. 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 labels (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 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 guarantees. compliance_match_mode: enum: - EXACT - CONTAINS type: string description: How to match other_compliance labels. has_affiliate_program: type: boolean description: Filter by affiliate-program presence. description: >- Explicit company capability, compliance, and business attributes. additionalProperties: false company_technology: type: object properties: exclude: type: array items: type: string maxItems: 20 description: >- STARTER+ canonical technologies to exclude (up to 20). include: type: array items: type: string maxItems: 20 description: >- STARTER+ canonical technologies to include (up to 20). description: STARTER+ technologies; FREE returns PLAN_REQUIRED. additionalProperties: false company_integrations: type: object properties: exclude: type: array items: type: string maxItems: 10 description: GROWTH+ integrations to exclude (up to 10). include: type: array items: type: string maxItems: 20 description: GROWTH+ integrations to include (up to 20). description: GROWTH+ integration filters. additionalProperties: false company_key_customers: type: object required: - include properties: include: type: array items: type: string maxItems: 100 minItems: 1 description: GROWTH+ customer names to include (1-100). description: GROWTH+ key-customer filters. 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. urls_only: type: boolean description: Search URLs only. page_titles: type: boolean description: Search page titles. headings_only: type: boolean description: Search headings only. seo_description: type: boolean description: Search SEO descriptions. description: PRO+ website areas to search. additionalProperties: false match_mode: enum: - any - all type: string description: PRO+ keyword matching mode. page_scope: type: array items: enum: - homepage - product - blog - careers - about type: string maxItems: 5 description: PRO+ page types to search. has_sla_page: type: boolean description: PRO+ filter by SLA-page presence. url_contains: type: string description: PRO+ URL substring. has_status_page: type: boolean description: PRO+ filter by status-page presence. exclude_keywords: type: array items: type: string maxItems: 10 description: PRO+ website keywords to exclude. has_careers_page: type: boolean description: PRO+ filter by careers-page presence. include_keywords: type: array items: type: string maxItems: 10 description: PRO+ website keywords to include. has_investor_page: type: boolean description: PRO+ filter by investor-page presence. has_persona_pages: type: boolean description: PRO+ filter by persona-page presence. has_security_page: type: boolean description: PRO+ filter by security-page presence. has_industry_pages: type: boolean description: PRO+ filter by industry-page presence. has_solution_pages: type: boolean description: PRO+ filter by solution-page presence. has_comparison_pages: type: boolean description: PRO+ filter by comparison-page presence. has_developer_docs_page: type: boolean description: PRO+ filter by developer-docs presence. description: PRO+ website-content and page-presence filters. 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; mutually exclusive with company_headcount_custom. company_location_search: type: object properties: exclude: type: array items: type: string maxItems: 100 description: >- Canonical locations to exclude. Resolve values with Search Filter Suggestions. include: type: array items: type: string maxItems: 100 description: >- Canonical locations to include. Resolve values with Search Filter Suggestions. description: Canonical company locations. additionalProperties: false company_website_traffic: type: object properties: visit_change: type: object properties: period: enum: - monthly - quarterly - yearly type: string description: Traffic-change period. max_change: type: number maximum: 10000 minimum: -100 description: Maximum visit change. min_change: type: number maximum: 10000 minimum: -100 description: Minimum visit change. description: PRO+ visit-change range. additionalProperties: false top_countries: type: array items: type: string maxItems: 5 minItems: 1 description: PRO+ top traffic countries (1-5). max_country_pct: type: number maximum: 100 minimum: 0 description: PRO+ maximum country traffic percentage. min_country_pct: type: number maximum: 100 minimum: 0 description: PRO+ minimum country traffic percentage. max_monthly_visits: type: integer maximum: 100000000 minimum: 0 description: PRO+ maximum monthly visits. min_monthly_visits: type: integer maximum: 100000000 minimum: 0 description: PRO+ minimum monthly visits. description: PRO+ website traffic filters. additionalProperties: false company_google_discovery: type: object required: - seo_keywords properties: seo_keywords: type: array items: type: string maxItems: 100 minItems: 1 description: PRO+ SEO discovery keywords (1-100). description: PRO+ Google discovery filters. additionalProperties: false company_headcount_custom: type: object properties: max: type: integer maximum: 999999 minimum: 1 description: Inclusive maximum employees. min: type: integer maximum: 999998 minimum: 1 description: Inclusive minimum employees. description: >- Custom employee-count range; mutually exclusive 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 to measure (up to 10). timeframe_month: enum: - 3 - 6 - 12 - 24 type: integer description: Growth measurement period in months. description: Headcount-growth filters. additionalProperties: false company_products_services: type: object properties: products_exclude: type: array items: type: string maxItems: 10 description: Products to exclude (up to 10). 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). 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 filters. 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 company_job_posting_quantity: type: object properties: max: type: integer maximum: 5000 minimum: 0 description: STARTER+ maximum active job postings. min: type: integer maximum: 5000 minimum: 0 description: STARTER+ minimum active job postings. description: STARTER+ active job-posting count. 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 headcount in the country. min_headcount: type: integer maximum: 1000000 minimum: 0 description: Minimum headcount in the country. maxItems: 10 minItems: 1 description: GROWTH+ country headcount entries (1-10). description: GROWTH+ country headcount filters. additionalProperties: false company_job_posting_hiring_for: type: object properties: exclude: type: array items: type: string maxItems: 500 description: STARTER+ job titles to exclude. include: type: array items: type: string maxItems: 500 description: STARTER+ job titles to include. match_type: enum: - contains - exact type: string description: STARTER+ title matching mode. boolean_search: type: string description: STARTER+ boolean title expression. description: STARTER+ hiring-title filters. 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 headcount ranges (up to 10). description: >- Typed company filters. Required on the first page and restored automatically from next_cursor on continuation pages. 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. responses: '200': description: Tool result data content: application/json: schema: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__public_data default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__public_data: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__50fb82737ab19e00 Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__50fb82737ab19e00: type: object properties: free: type: boolean results: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__2de7adc1a9a6bff0 has_more: type: boolean default: false pagination: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__8511499bd843a247 next_cursor: type: string Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__2de7adc1a9a6bff0: type: object properties: company: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__61793974067aa99d Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__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_COMPANIES__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_COMPANIES__output__41e0a0f43c268af5 website: type: string industry: type: string keywords: type: array items: type: string location: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__20b6b1d8f0c1ac14 logo_url: type: string phone_hq: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__ace429f86a5b29df sic_codes: type: array items: type: string attributes: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__a404af9a304faaac company_id: type: string email_tech: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__d2690f4547d1eb4b technology: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__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_COMPANIES__output__29f3030b5cbe0625 linkedin_url: type: string instagram_url: type: string revenue_range: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__acf006fceb26f928 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_COMPANIES__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_COMPANIES__output__e1c90c87812167fd latest_funding_date: type: string latest_funding_stage: type: string total_funding_printed: type: string Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__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_COMPANIES__output__ace429f86a5b29df: 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_COMPANIES__output__a404af9a304faaac: 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_COMPANIES__output__d2690f4547d1eb4b: type: object properties: domain: type: string mx_provider: type: string Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__9989b36731b61972: type: object properties: count: type: integer technology_list: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__f36345fe51fd3b43 technology_names: type: array items: type: string Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__29f3030b5cbe0625: type: object properties: active_count: type: integer active_titles: type: array items: type: string Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__acf006fceb26f928: type: object properties: max: anyOf: - type: integer - type: number min: anyOf: - type: integer - type: number Response576A0Ea506F3_connect_PROSPEO_SEARCH_COMPANIES__output__e1c90c87812167fd: 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_COMPANIES__output__f36345fe51fd3b43: 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.