[ { "name": "match_businesses", "description": "\n Get the Explorium business IDs from business name and/or domain in bulk.\n Use this when:\n - Need company size/revenue/industry\n - Analyzing overall business metrics\n - Researching company background\n - Looking for specific employees (use fetch_prospects next)\n\n Do NOT use when:\n - Looking for specific employees\n - Getting executive contact info\n - Finding team member details\n - You already called fetch_businesses - the response already contains business IDs\n ", "inputSchema": { "type": "object", "properties": { "businesses_to_match": { "items": { "$ref": "#/$defs/MatchBusinessInput" }, "maxItems": 50, "minItems": 1, "title": "Businesses To Match", "type": "array" } }, "$defs": { "MatchBusinessInput": { "description": "Business matching input.\n\nProvide one or more identifiers to enhance matching accuracy. Use both name and domain when available.", "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "The business name.", "title": "Name" }, "domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "The business domain or website URL.", "title": "Domain" } }, "title": "MatchBusinessInput", "type": "object" } }, "additionalProperties": false, "required": [ "businesses_to_match" ] } }, { "name": "fetch_businesses", "description": "\n Fetch businesses from the Explorium API using filter criteria.\n\n For filters backed by enums in the schema, use the enum values directly:\n - `company_revenue`\n - `company_age`\n - `company_size`\n - `number_of_locations`\n\n For the following filters, you MUST first call the `autocomplete` tool to retrieve valid values:\n - `linkedin_category`\n - `company_tech_stack_categories`\n - `job_title`\n - `google_category`\n - `naics_category`\n - `country_code`\n - `region_country_code`\n - `company_tech_stack_category`\n - `company_tech_stack_tech`\n - `company_name`\n - `city_region_country`\n\n Do NOT use this tool until all required autocomplete values have been retrieved.\n\n Rules:\n - Only one of `linkedin_category`, `google_category`, or `naics_category` can be set per request.\n - This tool returns Business IDs. Do NOT follow with `match_businesses`.\n - To get employee data for companies, use `fetch_prospects`.\n - If any filter is invalid or unsupported, stop and alert the user.\n ", "inputSchema": { "type": "object", "properties": { "filters": { "$ref": "#/$defs/FetchBusinessesFilters", "title": "Filters" }, "size": { "default": 1000, "description": "The number of businesses to return", "maximum": 1000, "title": "Size", "type": "integer" }, "page_size": { "default": 5, "description": "The number of businesses to return per page - recommended: 5", "maximum": 100, "title": "Page Size", "type": "integer" }, "page": { "default": 1, "description": "The page number to return", "title": "Page", "type": "integer" } }, "$defs": { "FetchBusinessesFilters": { "description": "Business search filters.\nOnly one of `linkedin_category`, `google_category`, or `naics_category` may be used per request.", "properties": { "country_code": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of ISO Alpha-2 country codes (e.g., 'US', 'IL') to filter companies by their main headquarters country.", "examples": [ [ "US", "IL" ] ], "title": "Country Code" }, "region_country_code": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of region-country codes (e.g., 'US-CA', 'IL-TA') to filter companies by their specific region.", "examples": [ [ "US-CA", "IL-TA" ] ], "title": "Region Country Code" }, "company_size": { "anyOf": [ { "items": { "description": "Company size based on employee count.", "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies based on number of employees (e.g.,'1-10', '51-200').", "examples": [ [ "11-50", "201-500" ] ], "title": "Company Size" }, "company_revenue": { "anyOf": [ { "items": { "description": "Company revenue range in USD (e.g., '1M-5M').", "enum": [ "0-500K", "500K-1M", "1M-5M", "5M-10M", "10M-25M", "25M-75M", "75M-200M", "200M-500M", "500M-1B", "1B-10B", "10B-100B", "100B-1T", "1T-10T", "10T+" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by annual revenue range in USD (e.g., '1M-5M', '500M-1B').", "examples": [ [ "200M-500M", "1B-10B" ] ], "title": "Company Revenue" }, "company_age": { "anyOf": [ { "items": { "description": "Company age in years (e.g., '6-10' means 6 to 10 years old).", "enum": [ "0-3", "3-6", "6-10", "10-20", "20+" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by age since founding (in years).", "examples": [ [ "0-3", "11-20" ] ], "title": "Company Age" }, "google_category": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by Google industry classification (e.g., 'Retail', 'Construction').", "examples": [ [ "Retail" ] ], "title": "Google Category" }, "naics_category": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by NAICS industry codes (e.g., '541512' for software services).", "examples": [ [ "541512", "611310" ] ], "title": "Naics Category" }, "linkedin_category": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by LinkedIn industry categories (e.g., 'Market research', 'Software').", "examples": [ [ "Market research", "Software" ] ], "title": "Linkedin Category" }, "company_tech_stack_category": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by broader technology categories (e.g., 'DevOps and Development', 'Marketing Tools'), autocomplete named 'company_tech_stack_categories'.", "examples": [ [ "DevOps and Development" ] ], "title": "Company Tech Stack Category" }, "company_tech_stack_tech": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter by specific technologies used by the company (e.g., 'Salesforce', 'Amazon RDS').", "examples": [ [ "Microsoft System Center", "Amazon RDS for MySQL" ] ], "title": "Company Tech Stack Tech" }, "company_name": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by exact or partial name match (e.g., 'Google', 'Stripe').", "examples": [ [ "Microsoft", "Google" ] ], "title": "Company Name" }, "number_of_locations": { "anyOf": [ { "items": { "description": "Number of physical company locations (e.g., offices, stores).", "enum": [ "0-1", "2-5", "6-20", "21-50", "51-100", "101-1000", "1001+" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter by how many physical office locations the company has.", "examples": [ [ "2-5", "101-1000" ] ], "title": "Number Of Locations" }, "city_region_country": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter by location string combining city, region, and country (e.g., 'Tel Aviv, IL', 'Miami, FL, US').", "examples": [ [ "Tel Aviv, IL", "Miami, FL, US" ] ], "title": "City Region Country" }, "website_keywords": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by keywords found on their website (e.g., 'AI', 'ecommerce', 'fintech').", "examples": [ [ "ecommerce", "retail", "AI" ] ], "title": "Website Keywords" } }, "title": "FetchBusinessesFilters", "type": "object" } }, "additionalProperties": false, "required": [ "filters" ] } }, { "name": "autocomplete", "description": "\n Autocomplete values for business filters based on a query.\n Never use for fields not explicitly listed (e.g., `website_keywords`).\n Prefer `linkedin_category` over `google_category` when both apply.\n Always call autocomplete requests in **parallel**, not sequentially.\n\n Hints:\n - Searching for SaaS? Use the keyword 'software'\n - Use 'country' to retrieve ISO codes\n ", "inputSchema": { "type": "object", "properties": { "field": { "description": "The field to autocomplete. Use only fields listed here. Never use autocomplete for a field not included in this list. If a field is not listed, it either has a fixed set of allowed values (e.g., `NumberOfEmployeesRange`), or should be used directly as-is with no autocomplete.", "enum": [ "country", "country_code", "region_country_code", "google_category", "naics_category", "linkedin_category", "company_tech_stack_tech", "company_tech_stack_categories", "job_title", "job_department", "city_region_country", "company_name" ], "title": "Field", "type": "string" }, "query": { "anyOf": [ { "type": "string" }, { "type": "integer" } ], "description": "The query to autocomplete", "title": "Query" } }, "additionalProperties": false, "required": [ "field", "query" ] } }, { "name": "fetch_businesses_events", "description": "\n Retrieves business-related events from the Explorium API in bulk.\n If you're looking for events related to role changes, you should use the\n prospects events tool instead.\n\n This is a VERY useful tool for researching a company's events and history.\n ", "inputSchema": { "type": "object", "properties": { "business_ids": { "description": "List of Explorium business IDs from match_businesses", "items": { "type": "string" }, "maxItems": 20, "minItems": 1, "title": "Business Ids", "type": "array" }, "event_types": { "description": "List of event types to fetch", "items": { "$ref": "#/$defs/BusinessEventType" }, "title": "Event Types", "type": "array" }, "timestamp_from": { "description": "ISO 8601 timestamp", "title": "Timestamp From", "type": "string" } }, "$defs": { "BusinessEventType": { "description": "Valid event types for the Explorium Business Events API.\n\nIPO_ANNOUNCEMENT: Company announces plans to go public through an initial public offering\n- link: str - Link to article\n- ipo_date: datetime - Date of IPO\n- event_id: str - News event ID\n- company_name: str - Company name\n- offer_amount: float - Company valuation\n- number_of_shares: int - Number of issued shares\n- stock_exchange: str - IPO stock exchange\n- event_time: datetime - News event timestamp\n- price_per_share: float - Price per share\n- ticker: str - Ticker\n\nNEW_FUNDING_ROUND: Company secures a new round of investment funding\n- founding_date: datetime - Date of funding round\n- amount_raised: float - Amount raised in funding\n- link: str - Link to article\n- founding_stage: str - Funding round stage\n- event_id: str - News event ID\n- event_time: datetime - News event timestamp\n- investors: str - Investors in funding round\n- lead_investor: str - Lead investor\n\nNEW_INVESTMENT: Company makes an investment in another business or venture\n- investment_date: datetime - News event timestamp\n- investment_type: str - Type of investment\n- event_time: datetime - News report publishing date\n- event_id: str - News event ID\n- investment_target: str - Target of investment\n- link: str - Link to article\n- investment_amount: float - Amount of investment\n\nNEW_PRODUCT: Company launches a new product or service\n- event_time: datetime - News event timestamp\n- event_id: str - News event ID\n- link: str - Link to article\n- product_name: str - Name of new product\n- product_description: str - Description of new product\n- product_category: str - Category of new product\n- product_launch_date: datetime - Launch date of new product\n\nNEW_OFFICE: Company opens a new office location\n- purpose_of_new_office: str - Purpose of new office\n- link: str - Link to article\n- opening_date: datetime - Date of office opening\n- event_id: str - News event ID\n- office_location: str - Location of new office\n- event_time: datetime - News report publishing date\n- number_of_employees: int - Number of employees at new office\n\nCLOSING_OFFICE: Company closes an existing office location\n- reason_for_closure: str - Reason for office closing\n- event_time: datetime - News report publishing date\n- office_location: str - Location of closing office\n- closure_date: datetime - Date of office closing\n- event_id: str - News event ID\n- number_of_employees_affected: int - Number of employees impacted\n- link: str - Link to article\n\nNEW_PARTNERSHIP: Company forms a strategic partnership with another organization\n- link: str - Link to article\n- partner_company: str - Name of partnering company\n- partnership_date: datetime - Date of partnership\n- event_time: datetime - News report publishing date\n- purpose_of_partnership: str - Partnership purpose\n- event_id: str - News event ID\n\nDEPARTMENT_INCREASE_*: Company announces an increase in a specific department\nDEPARTMENT_DECREASE_*: Company announces a decrease in a specific department\nPossible input departments: ENGINEERING, SALES, MARKETING, OPERATIONS, CUSTOMER_SERVICE, ALL\n- department_change: float - Quarterly change in department headcount\n- event_time: datetime - Department event timestamp\n- event_id: str - Department event ID\n- quarter_partition: str - Quarter when change occurred\n- insertion_time: str - Event collection timestamp\n- department: str - Name of department\n- change_type: str - Type of department change\n\nDEPARTMENT_HIRING_*: Company announces a hiring initiative in a specific department\nPossible input departments: CREATIVE, EDUCATION, ENGINEERING, FINANCE, HEALTH, HR, LEGAL, MARKETING, OPERATIONS, PROFESSIONAL, SALES, SUPPORT, TRADE, UNKNOWN\n- location: str - Location of hiring initiative\n- event_id: str - Company hiring event ID\n- event_time: datetime - When role was published\n- job_count: int - Number of open positions\n- job_titles: str - Job titles being hired for\n- department: str - Department hiring is occurring in\n\nEMPLOYEE_JOINED: Employee is hired by an organization\n- job_department: str - Employee's current job department\n- full_name: str - Employee's full name\n- job_role_title: str - Employee's current job title\n- event_id: str - Employee's event ID\n- linkedin_url: str - Employee's LinkedIn URL", "enum": [ "ipo_announcement", "new_funding_round", "new_investment", "new_product", "new_office", "closing_office", "new_partnership", "increase_in_engineering_department", "increase_in_sales_department", "increase_in_marketing_department", "increase_in_operations_department", "increase_in_customer_service_department", "increase_in_all_departments", "decrease_in_engineering_department", "decrease_in_sales_department", "decrease_in_marketing_department", "decrease_in_operations_department", "decrease_in_customer_service_department", "decrease_in_all_departments", "employee_joined_company", "hiring_in_creative_department", "hiring_in_education_department", "hiring_in_engineering_department", "hiring_in_finance_department", "hiring_in_health_department", "hiring_in_human_resources_department", "hiring_in_legal_department", "hiring_in_marketing_department", "hiring_in_operations_department", "hiring_in_professional_service_department", "hiring_in_sales_department", "hiring_in_support_department", "hiring_in_trade_department", "hiring_in_unknown_department" ], "title": "BusinessEventType", "type": "string" } }, "additionalProperties": false, "required": [ "business_ids", "event_types", "timestamp_from" ] } }, { "name": "fetch_businesses_statistics", "description": "\n Fetch aggregated insights into businesses by industry, revenue, employee count, and geographic distribution.\n ", "inputSchema": { "type": "object", "properties": { "filters": { "$ref": "#/$defs/FetchBusinessesFilters", "title": "Filters" } }, "$defs": { "FetchBusinessesFilters": { "description": "Business search filters.\nOnly one of `linkedin_category`, `google_category`, or `naics_category` may be used per request.", "properties": { "country_code": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of ISO Alpha-2 country codes (e.g., 'US', 'IL') to filter companies by their main headquarters country.", "examples": [ [ "US", "IL" ] ], "title": "Country Code" }, "region_country_code": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of region-country codes (e.g., 'US-CA', 'IL-TA') to filter companies by their specific region.", "examples": [ [ "US-CA", "IL-TA" ] ], "title": "Region Country Code" }, "company_size": { "anyOf": [ { "items": { "description": "Company size based on employee count.", "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies based on number of employees (e.g.,'1-10', '51-200').", "examples": [ [ "11-50", "201-500" ] ], "title": "Company Size" }, "company_revenue": { "anyOf": [ { "items": { "description": "Company revenue range in USD (e.g., '1M-5M').", "enum": [ "0-500K", "500K-1M", "1M-5M", "5M-10M", "10M-25M", "25M-75M", "75M-200M", "200M-500M", "500M-1B", "1B-10B", "10B-100B", "100B-1T", "1T-10T", "10T+" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by annual revenue range in USD (e.g., '1M-5M', '500M-1B').", "examples": [ [ "200M-500M", "1B-10B" ] ], "title": "Company Revenue" }, "company_age": { "anyOf": [ { "items": { "description": "Company age in years (e.g., '6-10' means 6 to 10 years old).", "enum": [ "0-3", "3-6", "6-10", "10-20", "20+" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by age since founding (in years).", "examples": [ [ "0-3", "11-20" ] ], "title": "Company Age" }, "google_category": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by Google industry classification (e.g., 'Retail', 'Construction').", "examples": [ [ "Retail" ] ], "title": "Google Category" }, "naics_category": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by NAICS industry codes (e.g., '541512' for software services).", "examples": [ [ "541512", "611310" ] ], "title": "Naics Category" }, "linkedin_category": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by LinkedIn industry categories (e.g., 'Market research', 'Software').", "examples": [ [ "Market research", "Software" ] ], "title": "Linkedin Category" }, "company_tech_stack_category": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by broader technology categories (e.g., 'DevOps and Development', 'Marketing Tools'), autocomplete named 'company_tech_stack_categories'.", "examples": [ [ "DevOps and Development" ] ], "title": "Company Tech Stack Category" }, "company_tech_stack_tech": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter by specific technologies used by the company (e.g., 'Salesforce', 'Amazon RDS').", "examples": [ [ "Microsoft System Center", "Amazon RDS for MySQL" ] ], "title": "Company Tech Stack Tech" }, "company_name": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by exact or partial name match (e.g., 'Google', 'Stripe').", "examples": [ [ "Microsoft", "Google" ] ], "title": "Company Name" }, "number_of_locations": { "anyOf": [ { "items": { "description": "Number of physical company locations (e.g., offices, stores).", "enum": [ "0-1", "2-5", "6-20", "21-50", "51-100", "101-1000", "1001+" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter by how many physical office locations the company has.", "examples": [ [ "2-5", "101-1000" ] ], "title": "Number Of Locations" }, "city_region_country": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter by location string combining city, region, and country (e.g., 'Tel Aviv, IL', 'Miami, FL, US').", "examples": [ [ "Tel Aviv, IL", "Miami, FL, US" ] ], "title": "City Region Country" }, "website_keywords": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter companies by keywords found on their website (e.g., 'AI', 'ecommerce', 'fintech').", "examples": [ [ "ecommerce", "retail", "AI" ] ], "title": "Website Keywords" } }, "title": "FetchBusinessesFilters", "type": "object" } }, "additionalProperties": false, "required": [ "filters" ] } }, { "name": "enrich_businesses_firmographics", "description": "\n Get firmographics data in bulk.\n Returns:\n - Business ID and name\n - Detailed business description\n - Website URL\n - Geographic information (country, region)\n - Industry classification (NAICS code and description)\n - SIC code and description\n - Stock ticker symbol (for public companies)\n - Company size (number of employees range)\n - Annual revenue range\n - LinkedIn industry category and profile URL\n\n **Do NOT use when**:\n - You need to find a specific employee at a company\n - Looking for leadership info of a company\n ", "inputSchema": { "type": "object", "properties": { "business_ids": { "description": "List of Explorium business IDs from match_businesses", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Business Ids", "type": "array" } }, "additionalProperties": false, "required": [ "business_ids" ] } }, { "name": "enrich_businesses_technographics", "description": "\n Get technographics data in bulk.\n Returns:\n - Full technology stack used by the business\n - Nested technology stack categorized by function (e.g., Sales, Marketing, DevOps)\n - Detailed breakdown by categories including:\n - Testing and QA tools\n - Sales software\n - Programming languages and frameworks\n - Productivity and operations tools\n - Product and design software\n - Platform and storage solutions\n - Operations software\n - Operations management tools\n - Marketing technologies\n - IT security solutions\n - IT management systems\n - HR software\n - Health tech applications\n - Finance and accounting tools\n - E-commerce platforms\n - DevOps and development tools\n - Customer management systems\n - Computer networks\n - Communications tools\n - Collaboration platforms\n - Business intelligence and analytics\n\n ", "inputSchema": { "type": "object", "properties": { "business_ids": { "description": "List of Explorium business IDs from match_businesses", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Business Ids", "type": "array" } }, "additionalProperties": false, "required": [ "business_ids" ] } }, { "name": "enrich_businesses_company_ratings", "description": "\n Get internal company ratings in bulk.\n Returns:\n - Employee satisfaction ratings across multiple categories\n - Company culture and work-life balance assessments\n - Management and leadership quality ratings\n - Career growth and advancement opportunities metrics\n - Interview experience feedback from candidates\n - Overall company reputation scores from current and former employees\n ", "inputSchema": { "type": "object", "properties": { "business_ids": { "description": "List of Explorium business IDs from match_businesses", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Business Ids", "type": "array" } }, "additionalProperties": false, "required": [ "business_ids" ] } }, { "name": "enrich_businesses_financial_metrics", "description": "\n Get financial metrics for **public companies only** in bulk.\n You may also use this tool when looking for leadership information (CEO, CTO, CFO, etc.)\n\n Returns:\n - Financial metrics including EBITDA, revenue, and cost of goods sold (COGS)\n - Profitability indicators like ROA (Return on Assets) and ROC (Return on Capital)\n - Asset turnover and working capital figures\n - Price-to-earnings ratio and enterprise value metrics\n - Executive leadership details including names, titles, and compensation\n - Earnings surprises with actual vs. estimated results\n - Peer companies for competitive analysis\n - Total shareholder return (TSR) metrics for various time periods\n ", "inputSchema": { "type": "object", "properties": { "business_ids": { "description": "List of Explorium business IDs from match_businesses", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Business Ids", "type": "array" }, "date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional ISO 8601 timestamp for financial metrics", "title": "Date" } }, "additionalProperties": false, "required": [ "business_ids" ] } }, { "name": "enrich_businesses_funding_and_acquisitions", "description": "\n Get businesses funding and acquisition history in bulk.\n Returns:\n - Detailed funding history including dates, amounts, and round types\n - IPO information including date and size\n - List of investors and lead investors for each funding round\n - Total known funding value\n - Current board members and advisors\n - Acquisition information (if applicable)\n - First and latest funding round details\n - Number of funding rounds and investors\n ", "inputSchema": { "type": "object", "properties": { "business_ids": { "description": "List of Explorium business IDs from match_businesses", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Business Ids", "type": "array" } }, "additionalProperties": false, "required": [ "business_ids" ] } }, { "name": "enrich_businesses_challenges", "description": "\n Get insights on the challenges, breaches, and competition of public companies.\n Returns:\n - Technological disruption challenges identified in SEC filings\n - Data security breaches and cybersecurity vulnerabilities\n - Market saturation concerns and competitive pressures\n - Data security and privacy regulatory compliance issues\n - Competitive landscape and market position challenges\n - Customer adoption risks and third-party dependencies\n - Links to official SEC filings and documents\n - Company identifiers including ticker symbols and CIK numbers\n - Filing dates and form types for regulatory submissions\n ", "inputSchema": { "type": "object", "properties": { "business_ids": { "description": "List of Explorium business IDs from match_businesses", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Business Ids", "type": "array" } }, "additionalProperties": false, "required": [ "business_ids" ] } }, { "name": "enrich_businesses_competitive_landscape", "description": "\n Get insights on the market landscape of public companies.\n Returns:\n - Competitive differentiation strategies from SEC filings\n - Key competitors identified in public disclosures\n - Company ticker symbols and CIK identifiers\n - Links to official SEC filings and documents\n - Filing dates and form types for regulatory submissions\n ", "inputSchema": { "type": "object", "properties": { "business_ids": { "description": "List of Explorium business IDs from match_businesses", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Business Ids", "type": "array" } }, "additionalProperties": false, "required": [ "business_ids" ] } }, { "name": "enrich_businesses_strategic_insights", "description": "\n Get strategic insights for public companies.\n Returns:\n - Strategic focus areas and company value propositions from SEC filings\n - Target market segments and customer demographics\n - Product development roadmaps and innovation initiatives\n - Marketing and sales strategies from public disclosures\n - Strategic partnerships and acquisition information\n - Company identifiers including ticker symbols and CIK numbers\n - Links to official SEC filings and documents\n - Filing dates and form types for regulatory submissions\n\n Do NOT use this when you need to find employees at a company.\n ", "inputSchema": { "type": "object", "properties": { "business_ids": { "description": "List of Explorium business IDs from match_businesses", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Business Ids", "type": "array" } }, "additionalProperties": false, "required": [ "business_ids" ] } }, { "name": "enrich_businesses_workforce_trends", "description": "\n Get workforce trends and department composition for companies.\n Returns:\n - Percentage breakdown of employees across different departments (engineering, sales, marketing, etc.)\n - Changes in department composition compared to previous quarter\n - Total employee profiles found per quarter\n - Quarterly timestamp information for trend analysis\n - Insights into company structure and hiring priorities\n - Department growth or reduction indicators\n ", "inputSchema": { "type": "object", "properties": { "business_ids": { "description": "List of Explorium business IDs from match_businesses", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Business Ids", "type": "array" } }, "additionalProperties": false, "required": [ "business_ids" ] } }, { "name": "enrich_businesses_linkedin_posts", "description": "\n Get LinkedIn posts for public companies.\n Returns:\n - Post text content from company LinkedIn posts\n - Engagement metrics including number of likes and comments\n - Publication dates and time since posting\n - Company display names when available\n - Historical social media content for trend analysis\n - Marketing messaging and brand voice examples\n - Product announcements and company updates\n ", "inputSchema": { "type": "object", "properties": { "business_ids": { "description": "List of Explorium business IDs from match_businesses", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Business Ids", "type": "array" } }, "additionalProperties": false, "required": [ "business_ids" ] } }, { "name": "enrich_businesses_website_changes", "description": "\n Get website changes for public companies.\n Returns:\n - Website content changes with before and after text comparisons\n - Strategic implications of content modifications\n - Dates when changes were detected\n - Changes in featured products, services, or content\n - Shifts in marketing messaging or positioning\n - Updates to promotional content and featured items\n - Changes in top charts or featured content listings\n - Insights into business strategy and market focus\n ", "inputSchema": { "type": "object", "properties": { "business_ids": { "description": "List of Explorium business IDs from match_businesses", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Business Ids", "type": "array" }, "keywords": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of keywords to search for in website changes", "title": "Keywords" } }, "additionalProperties": false, "required": [ "business_ids" ] } }, { "name": "enrich_businesses_website_keywords", "description": "\n Get website keywords for public companies.\n For each keyword, input multiple search terms separated by commas (\",\"), which simulates a logical \"AND\" operation.\n Returns:\n - Website URL\n - Keywords indicator showing if keywords were found\n - Text results containing:\n - Position/rank of the result\n - Text snippet showing keyword matches\n - URL where the keyword was found\n ", "inputSchema": { "type": "object", "properties": { "business_ids": { "description": "List of Explorium business IDs from match_businesses", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Business Ids", "type": "array" }, "keywords": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of keywords to search for in website keywords", "title": "Keywords" } }, "additionalProperties": false, "required": [ "business_ids" ] } }, { "name": "match_prospects", "description": "\n Get the Explorium prospect ID from a prospect's email, full name, and company.\n At least email OR (full name AND company) must be provided.\n You MUST use this tool if the input is about someone working at a specific company.\n\n Use this when:\n - Need prospect enrichment tools\n - Getting contact information\n - Analyzing an individual's social media presence\n - Gathering information on a person's professional profile and workplace\n\n Do NOT use for:\n - Finding leadership information (CEO, CTO, CFO, etc.)\n - Looking for employees at a company\n ", "inputSchema": { "type": "object", "properties": { "prospects_to_match": { "items": { "$ref": "#/$defs/ProspectMatchInput" }, "maxItems": 40, "minItems": 1, "title": "Prospects To Match", "type": "array" } }, "$defs": { "ProspectMatchInput": { "description": "Identifiers for matching a prospect.\nUse full_name and company_name together for an accurate match. Additional identifiers such as email,\nphone number, LinkedIn URL, or business ID can also be provided to enhance matching precision.", "properties": { "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "The prospect's email address.", "title": "Email" }, "phone_number": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "The prospect's phone number.", "title": "Phone Number" }, "full_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "The prospect's full name (can only be used together with company_name).", "title": "Full Name" }, "company_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "The prospect's company name (can only be used together with full_name).", "title": "Company Name" }, "linkedin": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Linkedin url.", "title": "Linkedin" }, "business_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filters the prospect to match the given business id.", "title": "Business Id" } }, "title": "ProspectMatchInput", "type": "object" } }, "additionalProperties": false, "required": [ "prospects_to_match" ] } }, { "name": "fetch_prospects", "description": "\n Fetch prospects (employees) from the Explorium API using detailed filter criteria.\n\n Use enum values directly for these filters:\n - `job_level`\n - `job_department`\n - `company_size`\n - `company_revenue`\n\n Before calling, you MUST use the `autocomplete` tool to obtain valid values for:\n - `linkedin_category`\n - `google_category`\n - `job_title`\n - `country_code`\n - `naics_category`\n - `region_country_code`\n - `company_region_country_code`\n - `company_country_code`\n - `city_region_country`\n - `company_name`\n\n Do **NOT** call this tool until all required autocomplete values are retrieved.\n\n Rules:\n - Only one of `linkedin_category`, `google_category`, or `naics_category` may be set per request.\n - This tool returns **Prospect IDs**. Do **NOT** chain with `match_businesses`.\n - For company‑level searches, use `fetch_businesses` instead.\n - If any filter is unsupported or invalid, stop and alert the user.\n ", "inputSchema": { "type": "object", "properties": { "filters": { "$ref": "#/$defs/FetchProspectsFilters", "title": "Filters" }, "size": { "default": 1000, "description": "The number of prospects to return", "maximum": 1000, "title": "Size", "type": "integer" }, "page_size": { "default": 5, "description": "The number of prospects to return per page - recommended: 5", "maximum": 100, "title": "Page Size", "type": "integer" }, "page": { "default": 1, "description": "The page number to return", "title": "Page", "type": "integer" } }, "$defs": { "FetchProspectsFilters": { "description": "Prospect search filters.\nOnly one of `linkedin_category`, `google_category`, or `naics_category` may be used per request.", "properties": { "has_email": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Filter prospects to include only those with a verified email address.", "examples": [ true ], "title": "Has Email" }, "has_phone_number": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Filter prospects to include only those with an available phone number.", "examples": [ true ], "title": "Has Phone Number" }, "job_level": { "anyOf": [ { "items": { "description": "Seniority level of the job (e.g., 'vp', 'manager', 'entry'). cxo is a catch-all for C-level positions such as CEO, CTO, etc.", "enum": [ "owner", "cxo", "vp", "director", "senior", "manager", "partner", "non-managerial", "entry", "training", "unpaid", "unknown" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter prospects based on their job seniority level (e.g., 'vp', 'director').", "examples": [ [ "vp", "director" ] ], "title": "Job Level" }, "job_department": { "anyOf": [ { "items": { "description": "Department or function in the organization (e.g., 'Engineering', 'Marketing').", "enum": [ "Real estate", "Customer service", "Trades", "Unknown", "Public relations", "Legal", "Operations", "Media", "Sales", "Marketing", "Finance", "Engineering", "Education", "General", "Health", "Design", "Human resources" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter prospects based on their department (e.g., 'Engineering', 'Marketing').", "examples": [ [ "Engineering", "Marketing" ] ], "title": "Job Department" }, "business_id": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter prospects by specifying one or more business IDs as registered in the system. Pass multiple IDs in a list to filter prospects that match any of the provided IDs.", "examples": [ [ "8adce3ca1cef0c986b22310e369a0793", "010146d2ec90d2e94b9dd85eced59d76" ] ], "title": "Business Id" }, "job_title": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Free text filter for prospect job titles (e.g., 'Software Engineer', 'Data Scientist').", "examples": [ [ "Software Engineer", "Data Scientist" ] ], "title": "Job Title" }, "country_code": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter prospects based on a 2-letter ISO Alpha-2 country code representing the prospect's location (e.g., 'US', 'CA').", "examples": [ [ "US", "CA" ] ], "title": "Country Code" }, "region_country_code": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter prospects based on a region code that combines a region identifier with the country's code (e.g., 'US-NY', 'IL-TA').", "examples": [ [ "US-NY", "IL-TA" ] ], "title": "Region Country Code" }, "company_country_code": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter prospects by the 2-letter ISO Alpha-2 country code where their company is primarily located.", "examples": [ [ "US" ] ], "title": "Company Country Code" }, "company_region_country_code": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter prospects by the region code (combining region and country) where their company is headquartered (e.g., 'US-CA').", "examples": [ [ "US-CA" ] ], "title": "Company Region Country Code" }, "city_region_country": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter prospects using a combined city, region, and country string (e.g., 'Miami, FL, US', 'Tel Aviv, IL').", "examples": [ [ "Miami, FL, US", "Tel Aviv, IL" ] ], "title": "City Region Country" }, "company_name": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Free text filter for the prospect's company name (e.g., 'Google', 'Microsoft').", "examples": [ [ "Google", "Microsoft" ] ], "title": "Company Name" }, "company_size": { "anyOf": [ { "items": { "description": "Company size based on employee count.", "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter prospects by the employee count range of their company (e.g., '11-50', '51-200').", "examples": [ [ "11-50", "51-200" ] ], "title": "Company Size" }, "company_revenue": { "anyOf": [ { "items": { "description": "Company revenue range in USD (e.g., '1M-5M').", "enum": [ "0-500K", "500K-1M", "1M-5M", "5M-10M", "10M-25M", "25M-75M", "75M-200M", "200M-500M", "500M-1B", "1B-10B", "10B-100B", "100B-1T", "1T-10T", "10T+" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter prospects by the revenue range of their company (e.g., '0-500K', '1M-5M').", "examples": [ [ "0-500K", "1M-5M" ] ], "title": "Company Revenue" }, "total_experience_months": { "anyOf": [ { "$ref": "#/$defs/RangeInt" }, { "type": "null" } ], "default": null, "description": "Filter prospects by their total work experience in months (e.g., between 12 and 120 months).", "examples": [ { "gte": 12, "lte": 120 } ] }, "current_role_months": { "anyOf": [ { "$ref": "#/$defs/RangeInt" }, { "type": "null" } ], "default": null, "description": "Filter prospects based on the number of months they have held their current role (e.g., between 6 and 24 months).", "examples": [ { "gte": 6, "lte": 24 } ] }, "google_category": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter prospects by their company's Google industry category (e.g., 'construction').", "examples": [ [ "construction" ] ], "title": "Google Category" }, "naics_category": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter prospects by their company's NAICS classification code (e.g., '541512' for software services).", "examples": [ [ "541512" ] ], "title": "Naics Category" }, "linkedin_category": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter prospects by their company's LinkedIn industry category (e.g., 'retail').", "examples": [ [ "retail" ] ], "title": "Linkedin Category" } }, "title": "FetchProspectsFilters", "type": "object" }, "RangeInt": { "description": "A class representing a range of integers with optional lower and upper bounds.", "properties": { "gte": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Greater than or equal to", "title": "Gte" }, "lte": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Less than or equal to", "title": "Lte" } }, "title": "RangeInt", "type": "object" } }, "additionalProperties": false, "required": [ "filters" ] } }, { "name": "fetch_prospects_events", "description": "\n Retrieves prospect-related events from the Explorium API in bulk.\n Use this when querying for prospect-related events about businesses:\n Example workflow:\n Fetch businesses > Fetch prospects > Fetch prospects events\n ", "inputSchema": { "type": "object", "properties": { "prospect_ids": { "description": "List of up to 50 Explorium prospect IDs from match_prospects", "items": { "type": "string" }, "maxItems": 20, "minItems": 1, "title": "Prospect Ids", "type": "array" }, "event_types": { "description": "List of event types to fetch", "items": { "$ref": "#/$defs/ProspectEventType" }, "title": "Event Types", "type": "array" }, "timestamp_from": { "description": "ISO 8601 timestamp", "title": "Timestamp From", "type": "string" } }, "$defs": { "ProspectEventType": { "description": "Valid event types for the Explorium Prospects Events API.\n\nJOB_TITLE_CHANGE: Individual transitioned to a new job title within their current company\n- previous_job_title: str - Employee's previous job title\n- event_time: datetime - Employee left previous role timestamp\n- current_job_title: str - Employee's current job title\n- current_company_name: str - Employee's current workplace\n- current_company_id: str - Current workplace entity ID\n- event_id: str - Job change event ID\n\nCOMPANY_CHANGE: Individual transitioned to a new company\n- previous_company_name: str - Employee's previous workplace name\n- previous_company_id: str - Previous workplace entity ID\n- previous_job_title: str - Employee's previous job title\n- event_time: datetime - Employee left previous company timestamp\n- current_company_name: str - Employee's current workplace name\n- current_company_id: str - Current workplace entity ID\n- current_job_title: str - Employee's current job title\n- event_id: str - Company change event ID\n\nWORKPLACE_ANNIVERSARY: Individual reached an annual milestone at their current company.\n- full_name: str - Employee's full name\n- event_id: str - Employee event ID\n- company_name: str - Workplace company name\n- years_at_company: int - Number of years at company\n- job_title: str - Employee's job title\n- job_anniversary_date: datetime - Employee event timestamp\n- event_time: datetime - Workplace anniversary date\n- linkedin_url: str - Employee LinkedIn URL", "enum": [ "prospect_changed_role", "prospect_changed_company", "prospect_job_start_anniversary" ], "title": "ProspectEventType", "type": "string" } }, "additionalProperties": false, "required": [ "prospect_ids", "event_types", "timestamp_from" ] } }, { "name": "enrich_prospects_contacts_information", "description": "\n Enrich prospect contact information with additional details.\n Returns:\n - Professional and personal email addresses\n - Email type (professional/personal)\n - Phone numbers\n ", "inputSchema": { "type": "object", "properties": { "prospect_ids": { "description": "List of up to 50 Explorium prospect IDs from match_prospects", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Prospect Ids", "type": "array" } }, "additionalProperties": false, "required": [ "prospect_ids" ] } }, { "name": "enrich_prospects_linkedin_posts", "description": "\n Enrich prospect LinkedIn posts with additional details.\n Returns:\n - Post text content\n - Post engagement metrics (likes, comments)\n - Post URLs\n - Post creation dates\n - Days since posted\n ", "inputSchema": { "type": "object", "properties": { "prospect_ids": { "description": "List of up to 50 Explorium prospect IDs from match_prospects", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Prospect Ids", "type": "array" } }, "additionalProperties": false, "required": [ "prospect_ids" ] } }, { "name": "enrich_prospects_profiles", "description": "\n Get detailed profile information for prospects.\n Returns:\n - Full name and demographic details (age group, gender)\n - Location information (country, region, city)\n - LinkedIn profile URL\n - Current role details:\n - Company name and website\n - Job title, department and seniority level\n - Work experience history:\n - Company names and websites\n - Job titles with role classifications\n - Start/end dates\n - Primary role indicator\n - Education background:\n - Schools attended with dates\n - Degrees, majors and minors\n - Skills and interests when available\n ", "inputSchema": { "type": "object", "properties": { "prospect_ids": { "description": "List of up to 50 Explorium prospect IDs from match_prospects", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "title": "Prospect Ids", "type": "array" } }, "additionalProperties": false, "required": [ "prospect_ids" ] } } ]