higherdata-sdk 0.5.0 → 0.7.0

package/dist/index.js

@@ -73,9 +73,11 @@ var TOOL_NAMES = [
   "lookup.person",
   "search.companies",
   "search.count",
+  "search.count_people",
   "search.facets",
   "search.filters_from_text",
   "search.people",
+  "search.preview_company_count",
   "searches.list",
   "searches.save",
   "suppress.add",
@@ -271,7 +273,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "account.limits",
-    "description": "Returns the current plan rate limits, concurrency and monthly email verification allowance.",
+    "description": "Returns the current plan rate limits, concurrency and available purchased verify credit balance.",
     "risk": "read",
     "scopes": [],
     "input": {
@@ -456,7 +458,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "account.usage",
-    "description": "Returns monthly activity, the email verification allowance and its reset time.",
+    "description": "Returns monthly activity, the available purchased verify credit balance.",
     "risk": "read",
     "scopes": [],
     "input": {
@@ -1919,7 +1921,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "email.find",
-    "description": "Find a person's work email from company pattern evidence. Tries at most three candidates in order and stops at the first deliverable. Dry run only plans candidates. Use the returned requestId to read or continue pending work.",
+    "description": "Find a person's work email from company pattern evidence. Tries at most three candidates in order and stops at the first deliverable. At zero verify credits, returns the best available pattern guess marked unverified. Dry run only plans candidates. Use the returned requestId to read or continue pending work.",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -1930,6 +1932,11 @@ var TOOL_CATALOG = [
         {
           "type": "object",
           "properties": {
+            "personId": {
+              "description": "Stable person id to attach the verified email to.",
+              "type": "string",
+              "pattern": "^hdp_[0-9a-f]{32}$"
+            },
             "firstName": {
               "type": "string",
               "minLength": 1,
@@ -1968,6 +1975,11 @@ var TOOL_CATALOG = [
                   "minLength": 1,
                   "maxLength": 240
                 },
+                "linkedinUrl": {
+                  "description": "LinkedIn company page URL.",
+                  "type": "string",
+                  "maxLength": 2048
+                },
                 "city": {
                   "description": "City of the headquarters.",
                   "type": "string",
@@ -2517,7 +2529,7 @@ var TOOL_CATALOG = [
                 }
               },
               "additionalProperties": false,
-              "description": "Company to match. Supply an id, a domain, or a name."
+              "description": "Company to match. Supply an id, a domain, a LinkedIn URL, or a name."
             }
           },
           "required": [
@@ -2547,7 +2559,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "email.verify",
-    "description": "Verify one email address. Dry run spends nothing. Returns a requestId for pending work; call this tool with requestId to read or continue it. Verification results use deliverable, undeliverable, risky or unknown.",
+    "description": "Verify one email address not already held for a contact. API callers may explicitly pass force to verify an existing address. Provider answers use purchased verify credits; cached answers are free. Dry run spends nothing. Returns a requestId for pending work; call this tool with requestId to read or continue it. Verification results use deliverable, undeliverable, risky or unknown.",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -2558,12 +2570,21 @@ var TOOL_CATALOG = [
         {
           "type": "object",
           "properties": {
+            "personId": {
+              "description": "Stable person id to attach the verified email to.",
+              "type": "string",
+              "pattern": "^hdp_[0-9a-f]{32}$"
+            },
             "email": {
               "type": "string",
               "maxLength": 320,
               "format": "email",
               "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
               "description": "Work email address to verify."
+            },
+            "force": {
+              "description": "API override to verify an address already held for a contact. Not offered in the UI.",
+              "type": "boolean"
             }
           },
           "required": [
@@ -2772,7 +2793,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "enrich.company",
-    "description": "Compare a company record with HigherData Core, using stable id, exact domain, then exact name and location. Name matches always require review. Dry run returns comparisons without recording them.  Insights fields and filters require the Insights or Unlimited plan.",
+    "description": "Compare a company record with HigherData Core, using stable id, LinkedIn URL, exact domain, then exact name and location. Name matches always require review. Dry run returns comparisons without recording them.  Insights fields and filters require the Insights or Complete plan.",
     "risk": "write_local",
     "scopes": [
       "data:read",
@@ -2799,6 +2820,11 @@ var TOOL_CATALOG = [
           "minLength": 1,
           "maxLength": 240
         },
+        "linkedinUrl": {
+          "description": "LinkedIn company page URL.",
+          "type": "string",
+          "maxLength": 2048
+        },
         "city": {
           "description": "City of the headquarters.",
           "type": "string",
@@ -3348,7 +3374,7 @@ var TOOL_CATALOG = [
         }
       },
       "additionalProperties": false,
-      "description": "Company to match. Supply an id, a domain, or a name."
+      "description": "Company to match. Supply an id, a domain, a LinkedIn URL, or a name."
     }
   },
   {
@@ -3422,8 +3448,7 @@ var TOOL_CATALOG = [
         "linkedinUrl": {
           "description": "LinkedIn person profile URL.",
           "type": "string",
-          "maxLength": 2048,
-          "format": "uri"
+          "maxLength": 2048
         },
         "name": {
           "description": "Person's full name.",
@@ -3432,7 +3457,7 @@ var TOOL_CATALOG = [
           "maxLength": 240
         },
         "company": {
-          "description": "Company this person works at. Supply an id, a domain, or a name.",
+          "description": "Company this person works at. Supply an id, a domain, a LinkedIn URL, or a name.",
           "type": "object",
           "properties": {
             "id": {
@@ -3452,6 +3477,11 @@ var TOOL_CATALOG = [
               "minLength": 1,
               "maxLength": 240
             },
+            "linkedinUrl": {
+              "description": "LinkedIn company page URL.",
+              "type": "string",
+              "maxLength": 2048
+            },
             "city": {
               "description": "City of the headquarters.",
               "type": "string",
@@ -5738,7 +5768,7 @@ var TOOL_CATALOG = [
                       }
                     },
                     "personNames": {
-                      "description": "Person name alternatives. Requires a company name, domain or id. Matches first or last name for one token, or first and last name for two tokens, ignoring case and accents.",
+                      "description": "Person name alternatives. Add a company name, domain or id for common names and typo matching. Every non-particle token matches in any order, ignoring case, accents and punctuation. Scoped searches allow one edit per token of at least five letters.",
                       "minItems": 1,
                       "maxItems": 5,
                       "type": "array",
@@ -6106,6 +6136,28 @@ var TOOL_CATALOG = [
                         "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                       }
                     },
+                    "sort": {
+                      "description": "Sort by primary company employee estimate, largest or smallest first. Unknown sizes come last. Available from the November 2026 release.",
+                      "type": "string",
+                      "enum": [
+                        "company_size_desc",
+                        "company_size_asc"
+                      ]
+                    },
+                    "firstName": {
+                      "description": "First name tokens, using accent-folded fuzzy matching. Requires companyId.",
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 120,
+                      "pattern": "\\S"
+                    },
+                    "lastName": {
+                      "description": "Last name tokens, using accent-folded fuzzy matching. Requires companyId.",
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 120,
+                      "pattern": "\\S"
+                    },
                     "companyId": {
                       "description": "Limit contacts to this company. This uses the company-indexed contact path and does not require country or industry filters.",
                       "type": "string",
@@ -6220,7 +6272,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "lists.export",
-    "description": "Export a saved list as paged CSV or JSONL with opaque ids. CSV escapes spreadsheet formulas. Pages contain at most 50 records.Insights fields and filters require the Insights or Unlimited plan.",
+    "description": "Export a saved list as paged CSV or JSONL with opaque ids. CSV escapes spreadsheet formulas. Pages contain at most 50 records.Insights fields and filters require the Insights or Complete plan.",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -6409,7 +6461,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "lookup.company",
-    "description": "Look up a company by exactly one domain, exact name (optionally with location), or opaque hdo_ id. Returns bounded candidates and ambiguity metadata.  Insights fields and filters require the Insights or Unlimited plan.",
+    "description": "Look up a company by exactly one domain, exact or near name (optionally with location), LinkedIn company page URL, or opaque hdo_ id, or up to 100 ids. Returns bounded candidates and ambiguity metadata.  Insights fields and filters require the Insights or Complete plan.",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -6434,7 +6486,7 @@ var TOOL_CATALOG = [
               "maximum": 5
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6477,7 +6529,7 @@ var TOOL_CATALOG = [
               "maximum": 5
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6497,7 +6549,7 @@ var TOOL_CATALOG = [
               "description": "Opaque company id (hdo_)."
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6507,6 +6559,59 @@ var TOOL_CATALOG = [
             "id"
           ],
           "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "ids": {
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^hdo_[0-9a-f]{32}$",
+                "description": "Opaque company id (hdo_)."
+              },
+              "description": "Look up up to 100 opaque company ids in one call."
+            },
+            "excludeListId": {
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+            }
+          },
+          "required": [
+            "ids"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "linkedinUrl": {
+              "type": "string",
+              "maxLength": 2048,
+              "description": "LinkedIn company page URL."
+            },
+            "candidateLimit": {
+              "default": 5,
+              "description": "Maximum candidates to return.",
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 5
+            },
+            "excludeListId": {
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+            }
+          },
+          "required": [
+            "linkedinUrl"
+          ],
+          "additionalProperties": false
         }
       ]
     }
@@ -6522,6 +6627,12 @@ var TOOL_CATALOG = [
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "object",
       "properties": {
+        "excludeListId": {
+          "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+        },
         "companyId": {
           "description": "Select a company from a previous ambiguous company-scoped lookup.",
           "type": "string",
@@ -6542,7 +6653,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "lookup.person",
-    "description": "Look up a person by exactly one work email, international phone, exact or prefix name, LinkedIn profile URL or opaque hdp_ id. Names may be narrowed by company name or domain. Matching includes people without email or a current company. ",
+    "description": "Look up a person by exactly one work email, international phone, token-matched name, LinkedIn profile URL or opaque hdp_ id. Names may be narrowed by company name or domain. Matching includes people without email or a current company. ",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -6568,7 +6679,7 @@ var TOOL_CATALOG = [
               "maximum": 5
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6595,7 +6706,7 @@ var TOOL_CATALOG = [
               "maximum": 5
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6635,7 +6746,7 @@ var TOOL_CATALOG = [
               "maximum": 20
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6652,7 +6763,6 @@ var TOOL_CATALOG = [
             "linkedinUrl": {
               "type": "string",
               "maxLength": 2048,
-              "format": "uri",
               "description": "LinkedIn person profile URL."
             },
             "candidateLimit": {
@@ -6663,7 +6773,7 @@ var TOOL_CATALOG = [
               "maximum": 5
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6690,10 +6800,14 @@ var TOOL_CATALOG = [
               "maximum": 5
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+            },
+            "includeEmployment": {
+              "description": "Include current and past jobs for this person, with suppression applied to each job.",
+              "type": "boolean"
             }
           },
           "required": [
@@ -6706,7 +6820,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "search.companies",
-    "description": "Find companies in HigherData Core using explicit filters. Optional domain uses exact website-host matching and ranks root sites first. Pages contain at most 50 records and opaque ids.  Insights fields and filters require the Insights or Unlimited plan.",
+    "description": "Find companies in HigherData Core using explicit filters. Optional domain uses exact website-host matching and ranks root sites first. Interactive pages contain at most 50 records. A download (download: true) contains at most 500 records and opaque ids.  Insights fields and filters require the Insights or Complete plan.",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -7057,10 +7171,10 @@ var TOOL_CATALOG = [
         },
         "limit": {
           "default": 50,
-          "description": "Maximum records in this page.",
+          "description": "Maximum records in this page. Interactive search accepts at most 50. A download (download true) accepts at most 500.",
           "type": "integer",
           "minimum": 1,
-          "maximum": 50
+          "maximum": 500
         },
         "cursor": {
           "description": "Cursor from the previous page. Omit it for the first page.",
@@ -7750,10 +7864,14 @@ var TOOL_CATALOG = [
           "additionalProperties": false
         },
         "excludeListId": {
-          "description": "Saved list whose members are left out of the result.",
+          "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
           "type": "string",
           "format": "uuid",
           "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+        },
+        "download": {
+          "description": "Set true to download a page. Interactive search stays at 50 records. The server reads this flag from the request, not from a plan or role.",
+          "type": "boolean"
         }
       },
       "additionalProperties": false
@@ -8796,8 +8914,8 @@ var TOOL_CATALOG = [
     }
   },
   {
-    "name": "search.facets",
-    "description": "Read release-built country, state, industry, NAICS, funding, department, seniority and role family values from HigherData Core, with optional country-scoped company, person or job city suggestions. Eligible plans also receive technology product suggestions.",
+    "name": "search.count_people",
+    "description": "Count people once by primary current job before suppression using release-built aggregates; search results may match other current jobs. Names and email use exact indexed counts. Unsupported refinements return an unavailable count, never a total that ignores them. exact: true explicitly requests one capped detailed count of matching people; never use it for live filtering.",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -8806,159 +8924,1213 @@ var TOOL_CATALOG = [
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "object",
       "properties": {
-        "cities": {
-          "description": "Get only city suggestions for these countries; omit this field for other suggestions. Person and job cities require a company country or industry.",
+        "filters": {
           "type": "object",
           "properties": {
-            "location": {
+            "companyNames": {
+              "description": "Company name alternatives or a domain. Finds the 50 closest token or prefix matches, ignoring punctuation, accents and legal suffixes.",
+              "minItems": 1,
+              "maxItems": 5,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "excludeCompanyNames": {
+              "description": "Company name prefixes to leave out.",
+              "minItems": 1,
+              "maxItems": 5,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "domain": {
+              "description": "Company website domain. Exact host matching; root sites rank first.",
               "type": "string",
-              "enum": [
-                "company",
-                "person",
-                "job"
-              ],
-              "description": "Location whose city suggestions should be read."
+              "minLength": 1,
+              "maxLength": 320
             },
             "countryCodes": {
+              "description": "Two-letter country codes to include.",
               "minItems": 1,
-              "maxItems": 5,
+              "maxItems": 50,
               "type": "array",
               "items": {
                 "type": "string",
-                "pattern": "^[A-Z]{2}$"
-              },
-              "description": "One to five location country codes for city suggestions."
+                "pattern": "^\\s*[a-z]{2}\\s*$"
+              }
             },
-            "companyCountryCodes": {
-              "description": "One to five company HQ countries to prune person or job suggestions.",
+            "stateCodes": {
+              "description": "State or region codes to include.",
               "minItems": 1,
-              "maxItems": 5,
+              "maxItems": 50,
               "type": "array",
               "items": {
                 "type": "string",
-                "pattern": "^[A-Z]{2}$"
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
               }
             },
             "industries": {
-              "description": "One to five company industries to prune person or job suggestions.",
+              "description": "Industries to include.",
               "minItems": 1,
-              "maxItems": 5,
+              "maxItems": 50,
               "type": "array",
               "items": {
                 "type": "string",
                 "minLength": 1,
-                "maxLength": 120
+                "maxLength": 120,
+                "pattern": "\\S"
               }
-            }
-          },
-          "required": [
-            "location",
-            "countryCodes"
-          ],
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false
-    }
-  },
-  {
-    "name": "search.filters_from_text",
-    "description": "Turn a sentence into proposed editable filters with a short explanation. Does not execute a search.",
-    "risk": "read",
-    "scopes": [
-      "data:read"
-    ],
-    "input": {
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "type": "object",
-      "properties": {
-        "text": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 4e3,
-          "description": "Sentence to turn into filters."
-        },
-        "kind": {
-          "default": "companies",
-          "description": "Whether the sentence describes companies or people.",
-          "type": "string",
-          "enum": [
-            "companies",
-            "people"
-          ]
-        }
-      },
-      "required": [
-        "text"
-      ],
-      "additionalProperties": false
-    }
-  },
-  {
-    "name": "search.people",
-    "description": "Find people in HigherData Core, with 1 to 5 positive company HQ country codes or industries required unless a company id, company name, domain or indexed email scopes the search. Person names require a company scope. Person, job and company location use distinct filters; each city filter requires its corresponding country. Company-scoped contacts also support legacy contactLocation filters. Pages contain at most 50 people and opaque ids. ",
-    "risk": "read",
-    "scopes": [
-      "data:read"
-    ],
-    "input": {
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "type": "object",
-      "properties": {
-        "companyNames": {
-          "description": "Company name alternatives or a domain. Finds the 50 closest token or prefix matches, ignoring punctuation, accents and legal suffixes.",
-          "minItems": 1,
-          "maxItems": 5,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "minLength": 1,
-            "maxLength": 120,
-            "pattern": "\\S"
-          }
-        },
-        "excludeCompanyNames": {
-          "description": "Company name prefixes to leave out.",
-          "minItems": 1,
-          "maxItems": 5,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "minLength": 1,
-            "maxLength": 120,
-            "pattern": "\\S"
-          }
-        },
-        "domain": {
-          "description": "Company website domain. Exact host matching; root sites rank first.",
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 320
-        },
-        "countryCodes": {
-          "description": "Two-letter country codes to include.",
-          "minItems": 1,
-          "maxItems": 50,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^\\s*[a-z]{2}\\s*$"
-          }
-        },
-        "stateCodes": {
-          "description": "State or region codes to include.",
-          "minItems": 1,
-          "maxItems": 50,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "minLength": 1,
-            "maxLength": 120,
-            "pattern": "\\S"
-          }
-        },
-        "industries": {
-          "description": "Industries to include.",
+            },
+            "excludeCountryCodes": {
+              "description": "Two-letter country codes to leave out.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^\\s*[a-z]{2}\\s*$"
+              }
+            },
+            "excludeStateCodes": {
+              "description": "State or region codes to leave out.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "excludeIndustries": {
+              "description": "Industries to leave out.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "employeeCountMin": {
+              "description": "Lowest employee count to include.",
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "employeeCountMax": {
+              "description": "Highest employee count to include.",
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "revenueMinUsd": {
+              "description": "Lowest annual revenue to include, in US dollars.",
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "revenueMaxUsd": {
+              "description": "Highest annual revenue to include, in US dollars.",
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "naics2022Codes": {
+              "description": "NAICS 2022 codes to include.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[0-9]{6}$"
+              }
+            },
+            "excludeNaics2022Codes": {
+              "description": "NAICS 2022 codes to leave out.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[0-9]{6}$"
+              }
+            },
+            "fundingTypes": {
+              "description": "Funding round types to include.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "excludeFundingTypes": {
+              "description": "Funding round types to leave out.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "keywords": {
+              "description": "Keywords to match. A company can match any of them.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "requiredKeywords": {
+              "description": "Keywords the company must match.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "requiredKeywordGroups": {
+              "description": "Keyword groups. The company must match every group, and any keyword inside a group.",
+              "maxItems": 10,
+              "type": "array",
+              "items": {
+                "minItems": 1,
+                "maxItems": 50,
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 120,
+                  "pattern": "\\S"
+                }
+              }
+            },
+            "excludeKeywords": {
+              "description": "Keywords that remove a company.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "websiteAvailability": {
+              "description": "Whether the company has a website.",
+              "type": "string",
+              "enum": [
+                "any",
+                "available",
+                "missing"
+              ]
+            },
+            "linkedinAvailability": {
+              "description": "Whether the company has a LinkedIn page.",
+              "type": "string",
+              "enum": [
+                "any",
+                "available",
+                "missing"
+              ]
+            },
+            "fundingDateAfter": {
+              "description": "Include funding on or after this date.",
+              "type": "string",
+              "format": "date",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+            },
+            "fundingDateBefore": {
+              "description": "Include funding on or before this date.",
+              "type": "string",
+              "format": "date",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+            },
+            "excludeOrganizationIds": {
+              "description": "Opaque company ids (hdo_) to leave out.",
+              "maxItems": 1e3,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^hdo_[0-9a-f]{32}$",
+                "description": "Opaque company id (hdo_)."
+              }
+            },
+            "excludeDomains": {
+              "description": "Website domains to leave out.",
+              "maxItems": 1e3,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 320
+              }
+            },
+            "personNames": {
+              "description": "Person name alternatives. Add a company name, domain or id for common names and typo matching. Every non-particle token matches in any order, ignoring case, accents and punctuation. Scoped searches allow one edit per token of at least five letters.",
+              "minItems": 1,
+              "maxItems": 5,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "email": {
+              "description": "Exact work email address, matched through the email index.",
+              "type": "string",
+              "maxLength": 320,
+              "format": "email",
+              "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+            },
+            "personCities": {
+              "description": "Person cities to include. Requires personCountryCodes.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "excludePersonCities": {
+              "description": "Person cities to leave out. Requires personCountryCodes.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "personStateCodes": {
+              "description": "Person state or region codes to include.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "excludePersonStateCodes": {
+              "description": "Person state or region codes to leave out.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "personCountryCodes": {
+              "description": "Person country codes to include.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^\\s*[a-z]{2}\\s*$"
+              }
+            },
+            "excludePersonCountryCodes": {
+              "description": "Person country codes to leave out.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^\\s*[a-z]{2}\\s*$"
+              }
+            },
+            "jobCities": {
+              "description": "Job cities to include. Requires jobCountryCodes.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "excludeJobCities": {
+              "description": "Job cities to leave out. Requires jobCountryCodes.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "jobStateCodes": {
+              "description": "Job state or region codes to include.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "excludeJobStateCodes": {
+              "description": "Job state or region codes to leave out.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "jobCountryCodes": {
+              "description": "Job country codes to include.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^\\s*[a-z]{2}\\s*$"
+              }
+            },
+            "excludeJobCountryCodes": {
+              "description": "Job country codes to leave out.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^\\s*[a-z]{2}\\s*$"
+              }
+            },
+            "companyCities": {
+              "description": "Company HQ cities to include. Requires countryCodes.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "excludeCompanyCities": {
+              "description": "Company HQ cities to leave out. Requires countryCodes.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "companyFoundedYearMin": {
+              "description": "Earliest company founding year.",
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "companyFoundedYearMax": {
+              "description": "Latest company founding year.",
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "jobStartDateAfter": {
+              "description": "Include jobs started on or after this date.",
+              "type": "string",
+              "format": "date",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+            },
+            "jobStartDateBefore": {
+              "description": "Include jobs started on or before this date.",
+              "type": "string",
+              "format": "date",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+            },
+            "titleKeywords": {
+              "description": "Job title keywords to match. A person can match any of them.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "requiredTitleKeywords": {
+              "description": "Job title keywords the person must match.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "requiredTitleKeywordGroups": {
+              "description": "Job title keyword groups. The person must match every group, and any keyword inside a group.",
+              "maxItems": 10,
+              "type": "array",
+              "items": {
+                "minItems": 1,
+                "maxItems": 50,
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 120,
+                  "pattern": "\\S"
+                }
+              }
+            },
+            "excludeTitleKeywords": {
+              "description": "Job title keywords that remove a person.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "jobFunctions": {
+              "description": "Job functions to include.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "excludeJobFunctions": {
+              "description": "Job functions to leave out.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "jobLevels": {
+              "description": "Job levels to include.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "excludeJobLevels": {
+              "description": "Job levels to leave out.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "gtmRoleFamilies": {
+              "description": "Go-to-market role families to include.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "excludeGtmRoleFamilies": {
+              "description": "Go-to-market role families to leave out.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "requireVerifiedEmail": {
+              "description": "When true, only people with a verified work email are returned.",
+              "type": "boolean"
+            },
+            "emailAvailability": {
+              "description": "Whether the person has an email address.",
+              "type": "string",
+              "enum": [
+                "any",
+                "available",
+                "missing"
+              ]
+            },
+            "phoneAvailability": {
+              "description": "Whether the person has a phone number.",
+              "type": "string",
+              "enum": [
+                "any",
+                "available",
+                "missing"
+              ]
+            },
+            "excludePersonIds": {
+              "description": "Opaque person ids (hdp_) to leave out.",
+              "maxItems": 1e3,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^hdp_[0-9a-f]{32}$",
+                "description": "Opaque person id (hdp_)."
+              }
+            },
+            "excludeEmails": {
+              "description": "Email addresses to leave out.",
+              "maxItems": 1e3,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "format": "email",
+                "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+              }
+            },
+            "firstName": {
+              "description": "First name tokens, using accent-folded fuzzy matching. Requires companyId.",
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 120,
+              "pattern": "\\S"
+            },
+            "lastName": {
+              "description": "Last name tokens, using accent-folded fuzzy matching. Requires companyId.",
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 120,
+              "pattern": "\\S"
+            },
+            "companyId": {
+              "description": "Limit contacts to this company. This uses the company-indexed contact path and does not require country or industry filters.",
+              "type": "string",
+              "pattern": "^hdo_[0-9a-f]{32}$"
+            },
+            "contactLocation": {
+              "description": "Contact location filters. Requires companyId.",
+              "type": "object",
+              "properties": {
+                "countryCodes": {
+                  "description": "Person or job location country codes.",
+                  "minItems": 1,
+                  "maxItems": 50,
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "pattern": "^\\s*[a-z]{2}\\s*$"
+                  }
+                },
+                "stateCodes": {
+                  "description": "Person or job location state codes.",
+                  "minItems": 1,
+                  "maxItems": 50,
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120,
+                    "pattern": "\\S"
+                  }
+                },
+                "cities": {
+                  "description": "Person or job location cities.",
+                  "minItems": 1,
+                  "maxItems": 50,
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120,
+                    "pattern": "\\S"
+                  }
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false,
+          "description": "People filters to count."
+        },
+        "exact": {
+          "default": false,
+          "description": "Explicitly request a detailed count when an indexed count is unavailable. Never enable for live filtering.",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "filters"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "search.facets",
+    "description": "Read release-built country, state, industry, NAICS, funding, department, seniority and role family values from HigherData Core, with optional country-scoped company, person or job city suggestions. Eligible plans also receive technology product suggestions.",
+    "risk": "read",
+    "scopes": [
+      "data:read"
+    ],
+    "input": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "cities": {
+          "description": "Get only city suggestions for these countries; omit this field for other suggestions. Person and job cities require a company country or industry.",
+          "type": "object",
+          "properties": {
+            "location": {
+              "type": "string",
+              "enum": [
+                "company",
+                "person",
+                "job"
+              ],
+              "description": "Location whose city suggestions should be read."
+            },
+            "countryCodes": {
+              "minItems": 1,
+              "maxItems": 5,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[A-Z]{2}$"
+              },
+              "description": "One to five location country codes for city suggestions."
+            },
+            "companyCountryCodes": {
+              "description": "One to five company HQ countries to prune person or job suggestions.",
+              "minItems": 1,
+              "maxItems": 5,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[A-Z]{2}$"
+              }
+            },
+            "industries": {
+              "description": "One to five company industries to prune person or job suggestions.",
+              "minItems": 1,
+              "maxItems": 5,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120
+              }
+            }
+          },
+          "required": [
+            "location",
+            "countryCodes"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "search.filters_from_text",
+    "description": "Turn a sentence into proposed editable filters with a short explanation. Does not execute a search.",
+    "risk": "read",
+    "scopes": [
+      "data:read"
+    ],
+    "input": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "text": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 4e3,
+          "description": "Sentence to turn into filters."
+        },
+        "kind": {
+          "default": "companies",
+          "description": "Whether the sentence describes companies or people.",
+          "type": "string",
+          "enum": [
+            "companies",
+            "people"
+          ]
+        }
+      },
+      "required": [
+        "text"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "search.people",
+    "description": "Find people in HigherData Core, with 1 to 5 positive company HQ country codes or industries required unless a company id, company name, domain or indexed email scopes the search. Unscoped person names use indexed tokens and bounded, ranked pages. Person, job and company location use distinct filters; each city filter requires its corresponding country. Company-scoped contacts also support legacy contactLocation filters. Interactive pages contain at most 50 people. A download (download: true) contains at most 500 people and opaque ids. ",
+    "risk": "read",
+    "scopes": [
+      "data:read"
+    ],
+    "input": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "companyNames": {
+          "description": "Company name alternatives or a domain. Finds the 50 closest token or prefix matches, ignoring punctuation, accents and legal suffixes.",
+          "minItems": 1,
+          "maxItems": 5,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "excludeCompanyNames": {
+          "description": "Company name prefixes to leave out.",
+          "minItems": 1,
+          "maxItems": 5,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "domain": {
+          "description": "Company website domain. Exact host matching; root sites rank first.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 320
+        },
+        "countryCodes": {
+          "description": "Two-letter country codes to include.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^\\s*[a-z]{2}\\s*$"
+          }
+        },
+        "stateCodes": {
+          "description": "State or region codes to include.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "industries": {
+          "description": "Industries to include.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "excludeCountryCodes": {
+          "description": "Two-letter country codes to leave out.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^\\s*[a-z]{2}\\s*$"
+          }
+        },
+        "excludeStateCodes": {
+          "description": "State or region codes to leave out.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "excludeIndustries": {
+          "description": "Industries to leave out.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "employeeCountMin": {
+          "description": "Lowest employee count to include.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "employeeCountMax": {
+          "description": "Highest employee count to include.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "revenueMinUsd": {
+          "description": "Lowest annual revenue to include, in US dollars.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "revenueMaxUsd": {
+          "description": "Highest annual revenue to include, in US dollars.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "naics2022Codes": {
+          "description": "NAICS 2022 codes to include.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[0-9]{6}$"
+          }
+        },
+        "excludeNaics2022Codes": {
+          "description": "NAICS 2022 codes to leave out.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[0-9]{6}$"
+          }
+        },
+        "fundingTypes": {
+          "description": "Funding round types to include.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "excludeFundingTypes": {
+          "description": "Funding round types to leave out.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "keywords": {
+          "description": "Keywords to match. A company can match any of them.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "requiredKeywords": {
+          "description": "Keywords the company must match.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "requiredKeywordGroups": {
+          "description": "Keyword groups. The company must match every group, and any keyword inside a group.",
+          "maxItems": 10,
+          "type": "array",
+          "items": {
+            "minItems": 1,
+            "maxItems": 50,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 120,
+              "pattern": "\\S"
+            }
+          }
+        },
+        "excludeKeywords": {
+          "description": "Keywords that remove a company.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "websiteAvailability": {
+          "description": "Whether the company has a website.",
+          "type": "string",
+          "enum": [
+            "any",
+            "available",
+            "missing"
+          ]
+        },
+        "linkedinAvailability": {
+          "description": "Whether the company has a LinkedIn page.",
+          "type": "string",
+          "enum": [
+            "any",
+            "available",
+            "missing"
+          ]
+        },
+        "fundingDateAfter": {
+          "description": "Include funding on or after this date.",
+          "type": "string",
+          "format": "date",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+        },
+        "fundingDateBefore": {
+          "description": "Include funding on or before this date.",
+          "type": "string",
+          "format": "date",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+        },
+        "excludeOrganizationIds": {
+          "description": "Opaque company ids (hdo_) to leave out.",
+          "maxItems": 1e3,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^hdo_[0-9a-f]{32}$",
+            "description": "Opaque company id (hdo_)."
+          }
+        },
+        "excludeDomains": {
+          "description": "Website domains to leave out.",
+          "maxItems": 1e3,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 320
+          }
+        },
+        "personNames": {
+          "description": "Person name alternatives. Add a company name, domain or id for common names and typo matching. Every non-particle token matches in any order, ignoring case, accents and punctuation. Scoped searches allow one edit per token of at least five letters.",
+          "minItems": 1,
+          "maxItems": 5,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "email": {
+          "description": "Exact work email address, matched through the email index.",
+          "type": "string",
+          "maxLength": 320,
+          "format": "email",
+          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+        },
+        "personCities": {
+          "description": "Person cities to include. Requires personCountryCodes.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "excludePersonCities": {
+          "description": "Person cities to leave out. Requires personCountryCodes.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "personStateCodes": {
+          "description": "Person state or region codes to include.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "excludePersonStateCodes": {
+          "description": "Person state or region codes to leave out.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "personCountryCodes": {
+          "description": "Person country codes to include.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^\\s*[a-z]{2}\\s*$"
+          }
+        },
+        "excludePersonCountryCodes": {
+          "description": "Person country codes to leave out.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^\\s*[a-z]{2}\\s*$"
+          }
+        },
+        "jobCities": {
+          "description": "Job cities to include. Requires jobCountryCodes.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "excludeJobCities": {
+          "description": "Job cities to leave out. Requires jobCountryCodes.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "jobStateCodes": {
+          "description": "Job state or region codes to include.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -8969,8 +10141,20 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "excludeCountryCodes": {
-          "description": "Two-letter country codes to leave out.",
+        "excludeJobStateCodes": {
+          "description": "Job state or region codes to leave out.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "jobCountryCodes": {
+          "description": "Job country codes to include.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -8979,8 +10163,18 @@ var TOOL_CATALOG = [
             "pattern": "^\\s*[a-z]{2}\\s*$"
           }
         },
-        "excludeStateCodes": {
-          "description": "State or region codes to leave out.",
+        "excludeJobCountryCodes": {
+          "description": "Job country codes to leave out.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^\\s*[a-z]{2}\\s*$"
+          }
+        },
+        "companyCities": {
+          "description": "Company HQ cities to include. Requires countryCodes.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -8991,8 +10185,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "excludeIndustries": {
-          "description": "Industries to leave out.",
+        "excludeCompanyCities": {
+          "description": "Company HQ cities to leave out. Requires countryCodes.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9003,52 +10197,72 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "employeeCountMin": {
-          "description": "Lowest employee count to include.",
+        "companyFoundedYearMin": {
+          "description": "Earliest company founding year.",
           "type": "integer",
           "minimum": 0,
           "maximum": 9007199254740991
         },
-        "employeeCountMax": {
-          "description": "Highest employee count to include.",
+        "companyFoundedYearMax": {
+          "description": "Latest company founding year.",
           "type": "integer",
           "minimum": 0,
           "maximum": 9007199254740991
         },
-        "revenueMinUsd": {
-          "description": "Lowest annual revenue to include, in US dollars.",
-          "type": "integer",
-          "minimum": 0,
-          "maximum": 9007199254740991
+        "jobStartDateAfter": {
+          "description": "Include jobs started on or after this date.",
+          "type": "string",
+          "format": "date",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
         },
-        "revenueMaxUsd": {
-          "description": "Highest annual revenue to include, in US dollars.",
-          "type": "integer",
-          "minimum": 0,
-          "maximum": 9007199254740991
+        "jobStartDateBefore": {
+          "description": "Include jobs started on or before this date.",
+          "type": "string",
+          "format": "date",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
         },
-        "naics2022Codes": {
-          "description": "NAICS 2022 codes to include.",
+        "titleKeywords": {
+          "description": "Job title keywords to match. A person can match any of them.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
           "items": {
             "type": "string",
-            "pattern": "^[0-9]{6}$"
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
           }
         },
-        "excludeNaics2022Codes": {
-          "description": "NAICS 2022 codes to leave out.",
+        "requiredTitleKeywords": {
+          "description": "Job title keywords the person must match.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
           "items": {
             "type": "string",
-            "pattern": "^[0-9]{6}$"
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
           }
         },
-        "fundingTypes": {
-          "description": "Funding round types to include.",
+        "requiredTitleKeywordGroups": {
+          "description": "Job title keyword groups. The person must match every group, and any keyword inside a group.",
+          "maxItems": 10,
+          "type": "array",
+          "items": {
+            "minItems": 1,
+            "maxItems": 50,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 120,
+              "pattern": "\\S"
+            }
+          }
+        },
+        "excludeTitleKeywords": {
+          "description": "Job title keywords that remove a person.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9059,8 +10273,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "excludeFundingTypes": {
-          "description": "Funding round types to leave out.",
+        "jobFunctions": {
+          "description": "Job functions to include.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9071,8 +10285,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "keywords": {
-          "description": "Keywords to match. A company can match any of them.",
+        "excludeJobFunctions": {
+          "description": "Job functions to leave out.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9083,8 +10297,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "requiredKeywords": {
-          "description": "Keywords the company must match.",
+        "jobLevels": {
+          "description": "Job levels to include.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9095,24 +10309,20 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "requiredKeywordGroups": {
-          "description": "Keyword groups. The company must match every group, and any keyword inside a group.",
-          "maxItems": 10,
+        "excludeJobLevels": {
+          "description": "Job levels to leave out.",
+          "minItems": 1,
+          "maxItems": 50,
           "type": "array",
           "items": {
-            "minItems": 1,
-            "maxItems": 50,
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1,
-              "maxLength": 120,
-              "pattern": "\\S"
-            }
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
           }
         },
-        "excludeKeywords": {
-          "description": "Keywords that remove a company.",
+        "gtmRoleFamilies": {
+          "description": "Go-to-market role families to include.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9123,8 +10333,24 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "websiteAvailability": {
-          "description": "Whether the company has a website.",
+        "excludeGtmRoleFamilies": {
+          "description": "Go-to-market role families to leave out.",
+          "minItems": 1,
+          "maxItems": 50,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "pattern": "\\S"
+          }
+        },
+        "requireVerifiedEmail": {
+          "description": "When true, only people with a verified work email are returned.",
+          "type": "boolean"
+        },
+        "emailAvailability": {
+          "description": "Whether the person has an email address.",
           "type": "string",
           "enum": [
             "any",
@@ -9132,8 +10358,8 @@ var TOOL_CATALOG = [
             "missing"
           ]
         },
-        "linkedinAvailability": {
-          "description": "Whether the company has a LinkedIn page.",
+        "phoneAvailability": {
+          "description": "Whether the person has a phone number.",
           "type": "string",
           "enum": [
             "any",
@@ -9141,40 +10367,134 @@ var TOOL_CATALOG = [
             "missing"
           ]
         },
-        "fundingDateAfter": {
-          "description": "Include funding on or after this date.",
-          "type": "string",
-          "format": "date",
-          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
-        },
-        "fundingDateBefore": {
-          "description": "Include funding on or before this date.",
-          "type": "string",
-          "format": "date",
-          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+        "excludePersonIds": {
+          "description": "Opaque person ids (hdp_) to leave out.",
+          "maxItems": 1e3,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^hdp_[0-9a-f]{32}$",
+            "description": "Opaque person id (hdp_)."
+          }
         },
-        "excludeOrganizationIds": {
-          "description": "Opaque company ids (hdo_) to leave out.",
+        "excludeEmails": {
+          "description": "Email addresses to leave out.",
           "maxItems": 1e3,
           "type": "array",
           "items": {
             "type": "string",
-            "pattern": "^hdo_[0-9a-f]{32}$",
-            "description": "Opaque company id (hdo_)."
+            "format": "email",
+            "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
           }
         },
-        "excludeDomains": {
-          "description": "Website domains to leave out.",
-          "maxItems": 1e3,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "minLength": 1,
-            "maxLength": 320
-          }
+        "sort": {
+          "description": "Sort by primary company employee estimate, largest or smallest first. Unknown sizes come last. Available from the November 2026 release.",
+          "type": "string",
+          "enum": [
+            "company_size_desc",
+            "company_size_asc"
+          ]
+        },
+        "limit": {
+          "default": 50,
+          "description": "Maximum records in this page. Interactive search accepts at most 50. A download (download true) accepts at most 500.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 500
+        },
+        "cursor": {
+          "description": "Cursor from the previous page. Omit it for the first page.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2048
+        },
+        "firstName": {
+          "description": "First name tokens, using accent-folded fuzzy matching. Requires companyId.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 120,
+          "pattern": "\\S"
+        },
+        "lastName": {
+          "description": "Last name tokens, using accent-folded fuzzy matching. Requires companyId.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 120,
+          "pattern": "\\S"
+        },
+        "companyId": {
+          "description": "Limit contacts to this company. This uses the company-indexed contact path and does not require country or industry filters.",
+          "type": "string",
+          "pattern": "^hdo_[0-9a-f]{32}$"
+        },
+        "contactLocation": {
+          "description": "Contact location filters. Requires companyId.",
+          "type": "object",
+          "properties": {
+            "countryCodes": {
+              "description": "Person or job location country codes.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^\\s*[a-z]{2}\\s*$"
+              }
+            },
+            "stateCodes": {
+              "description": "Person or job location state codes.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            },
+            "cities": {
+              "description": "Person or job location cities.",
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "pattern": "\\S"
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "excludeListId": {
+          "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
         },
-        "personNames": {
-          "description": "Person name alternatives. Requires a company name, domain or id. Matches first or last name for one token, or first and last name for two tokens, ignoring case and accents.",
+        "download": {
+          "description": "Set true to download a page. Interactive search stays at 50 records. The server reads this flag from the request, not from a plan or role.",
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "search.preview_company_count",
+    "description": "Cheap live company count from the release rollup only, before suppression. Refinements not covered by the rollup produce a baseline.",
+    "risk": "read",
+    "scopes": [
+      "data:read"
+    ],
+    "input": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "companyNames": {
+          "description": "Company name prefixes. Match any name.",
           "minItems": 1,
           "maxItems": 5,
           "type": "array",
@@ -9185,17 +10505,10 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "email": {
-          "description": "Exact work email address, matched through the email index.",
-          "type": "string",
-          "maxLength": 320,
-          "format": "email",
-          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
-        },
-        "personCities": {
-          "description": "Person cities to include. Requires personCountryCodes.",
+        "excludeCompanyNames": {
+          "description": "Company name prefixes to leave out.",
           "minItems": 1,
-          "maxItems": 50,
+          "maxItems": 5,
           "type": "array",
           "items": {
             "type": "string",
@@ -9204,20 +10517,24 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "excludePersonCities": {
-          "description": "Person cities to leave out. Requires personCountryCodes.",
+        "domain": {
+          "description": "Company website domain. Exact host matching; root sites rank first.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 320
+        },
+        "countryCodes": {
+          "description": "Two-letter country codes to include.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
           "items": {
             "type": "string",
-            "minLength": 1,
-            "maxLength": 120,
-            "pattern": "\\S"
+            "pattern": "^\\s*[a-z]{2}\\s*$"
           }
         },
-        "personStateCodes": {
-          "description": "Person state or region codes to include.",
+        "stateCodes": {
+          "description": "State or region codes to include.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9228,8 +10545,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "excludePersonStateCodes": {
-          "description": "Person state or region codes to leave out.",
+        "cities": {
+          "description": "Company HQ cities to include. Requires countryCodes.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9240,28 +10557,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "personCountryCodes": {
-          "description": "Person country codes to include.",
-          "minItems": 1,
-          "maxItems": 50,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^\\s*[a-z]{2}\\s*$"
-          }
-        },
-        "excludePersonCountryCodes": {
-          "description": "Person country codes to leave out.",
-          "minItems": 1,
-          "maxItems": 50,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^\\s*[a-z]{2}\\s*$"
-          }
-        },
-        "jobCities": {
-          "description": "Job cities to include. Requires jobCountryCodes.",
+        "excludeCities": {
+          "description": "Company HQ cities to leave out. Requires countryCodes.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9272,8 +10569,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "excludeJobCities": {
-          "description": "Job cities to leave out. Requires jobCountryCodes.",
+        "postcodes": {
+          "description": "Company HQ postcode prefixes to include.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9284,8 +10581,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "jobStateCodes": {
-          "description": "Job state or region codes to include.",
+        "excludePostcodes": {
+          "description": "Company HQ postcode prefixes to leave out.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9296,8 +10593,32 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "excludeJobStateCodes": {
-          "description": "Job state or region codes to leave out.",
+        "foundedYearMin": {
+          "description": "Earliest company founding year.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "foundedYearMax": {
+          "description": "Latest company founding year.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "totalFundingMinUsd": {
+          "description": "Lowest total company funding, in US dollars.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "totalFundingMaxUsd": {
+          "description": "Highest total company funding, in US dollars.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "industries": {
+          "description": "Industries to include.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9308,18 +10629,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "jobCountryCodes": {
-          "description": "Job country codes to include.",
-          "minItems": 1,
-          "maxItems": 50,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^\\s*[a-z]{2}\\s*$"
-          }
-        },
-        "excludeJobCountryCodes": {
-          "description": "Job country codes to leave out.",
+        "excludeCountryCodes": {
+          "description": "Two-letter country codes to leave out.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9328,8 +10639,8 @@ var TOOL_CATALOG = [
             "pattern": "^\\s*[a-z]{2}\\s*$"
           }
         },
-        "companyCities": {
-          "description": "Company HQ cities to include. Requires countryCodes.",
+        "excludeStateCodes": {
+          "description": "State or region codes to leave out.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9340,8 +10651,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "excludeCompanyCities": {
-          "description": "Company HQ cities to leave out. Requires countryCodes.",
+        "excludeIndustries": {
+          "description": "Industries to leave out.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9352,96 +10663,52 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "companyFoundedYearMin": {
-          "description": "Earliest company founding year.",
+        "employeeCountMin": {
+          "description": "Lowest employee count to include.",
           "type": "integer",
           "minimum": 0,
           "maximum": 9007199254740991
         },
-        "companyFoundedYearMax": {
-          "description": "Latest company founding year.",
+        "employeeCountMax": {
+          "description": "Highest employee count to include.",
           "type": "integer",
           "minimum": 0,
           "maximum": 9007199254740991
         },
-        "jobStartDateAfter": {
-          "description": "Include jobs started on or after this date.",
-          "type": "string",
-          "format": "date",
-          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
-        },
-        "jobStartDateBefore": {
-          "description": "Include jobs started on or before this date.",
-          "type": "string",
-          "format": "date",
-          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
-        },
-        "titleKeywords": {
-          "description": "Job title keywords to match. A person can match any of them.",
-          "minItems": 1,
-          "maxItems": 50,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "minLength": 1,
-            "maxLength": 120,
-            "pattern": "\\S"
-          }
-        },
-        "requiredTitleKeywords": {
-          "description": "Job title keywords the person must match.",
-          "minItems": 1,
-          "maxItems": 50,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "minLength": 1,
-            "maxLength": 120,
-            "pattern": "\\S"
-          }
+        "revenueMinUsd": {
+          "description": "Lowest annual revenue to include, in US dollars.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
         },
-        "requiredTitleKeywordGroups": {
-          "description": "Job title keyword groups. The person must match every group, and any keyword inside a group.",
-          "maxItems": 10,
-          "type": "array",
-          "items": {
-            "minItems": 1,
-            "maxItems": 50,
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1,
-              "maxLength": 120,
-              "pattern": "\\S"
-            }
-          }
+        "revenueMaxUsd": {
+          "description": "Highest annual revenue to include, in US dollars.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
         },
-        "excludeTitleKeywords": {
-          "description": "Job title keywords that remove a person.",
+        "naics2022Codes": {
+          "description": "NAICS 2022 codes to include.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
           "items": {
             "type": "string",
-            "minLength": 1,
-            "maxLength": 120,
-            "pattern": "\\S"
+            "pattern": "^[0-9]{6}$"
           }
         },
-        "jobFunctions": {
-          "description": "Job functions to include.",
+        "excludeNaics2022Codes": {
+          "description": "NAICS 2022 codes to leave out.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
           "items": {
             "type": "string",
-            "minLength": 1,
-            "maxLength": 120,
-            "pattern": "\\S"
+            "pattern": "^[0-9]{6}$"
           }
         },
-        "excludeJobFunctions": {
-          "description": "Job functions to leave out.",
+        "fundingTypes": {
+          "description": "Funding round types to include.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9452,8 +10719,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "jobLevels": {
-          "description": "Job levels to include.",
+        "excludeFundingTypes": {
+          "description": "Funding round types to leave out.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9464,8 +10731,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "excludeJobLevels": {
-          "description": "Job levels to leave out.",
+        "keywords": {
+          "description": "Keywords to match. A company can match any of them.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9476,8 +10743,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "gtmRoleFamilies": {
-          "description": "Go-to-market role families to include.",
+        "requiredKeywords": {
+          "description": "Keywords the company must match.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9488,8 +10755,24 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "excludeGtmRoleFamilies": {
-          "description": "Go-to-market role families to leave out.",
+        "requiredKeywordGroups": {
+          "description": "Keyword groups. The company must match every group, and any keyword inside a group.",
+          "maxItems": 10,
+          "type": "array",
+          "items": {
+            "minItems": 1,
+            "maxItems": 50,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 120,
+              "pattern": "\\S"
+            }
+          }
+        },
+        "excludeKeywords": {
+          "description": "Keywords that remove a company.",
           "minItems": 1,
           "maxItems": 50,
           "type": "array",
@@ -9500,12 +10783,8 @@ var TOOL_CATALOG = [
             "pattern": "\\S"
           }
         },
-        "requireVerifiedEmail": {
-          "description": "When true, only people with a verified work email are returned.",
-          "type": "boolean"
-        },
-        "emailAvailability": {
-          "description": "Whether the person has an email address.",
+        "websiteAvailability": {
+          "description": "Whether the company has a website.",
           "type": "string",
           "enum": [
             "any",
@@ -9513,8 +10792,8 @@ var TOOL_CATALOG = [
             "missing"
           ]
         },
-        "phoneAvailability": {
-          "description": "Whether the person has a phone number.",
+        "linkedinAvailability": {
+          "description": "Whether the company has a LinkedIn page.",
           "type": "string",
           "enum": [
             "any",
@@ -9522,90 +10801,718 @@ var TOOL_CATALOG = [
             "missing"
           ]
         },
-        "excludePersonIds": {
-          "description": "Opaque person ids (hdp_) to leave out.",
+        "fundingDateAfter": {
+          "description": "Include funding on or after this date.",
+          "type": "string",
+          "format": "date",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+        },
+        "fundingDateBefore": {
+          "description": "Include funding on or before this date.",
+          "type": "string",
+          "format": "date",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+        },
+        "excludeOrganizationIds": {
+          "description": "Opaque company ids (hdo_) to leave out.",
           "maxItems": 1e3,
           "type": "array",
           "items": {
             "type": "string",
-            "pattern": "^hdp_[0-9a-f]{32}$",
-            "description": "Opaque person id (hdp_)."
+            "pattern": "^hdo_[0-9a-f]{32}$",
+            "description": "Opaque company id (hdo_)."
           }
         },
-        "excludeEmails": {
-          "description": "Email addresses to leave out.",
+        "excludeDomains": {
+          "description": "Website domains to leave out.",
           "maxItems": 1e3,
           "type": "array",
           "items": {
             "type": "string",
-            "format": "email",
-            "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+            "minLength": 1,
+            "maxLength": 320
           }
         },
-        "limit": {
-          "default": 50,
-          "description": "Maximum records in this page.",
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 50
-        },
-        "cursor": {
-          "description": "Cursor from the previous page. Omit it for the first page.",
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 2048
-        },
-        "companyId": {
-          "description": "Limit contacts to this company. This uses the company-indexed contact path and does not require country or industry filters.",
-          "type": "string",
-          "pattern": "^hdo_[0-9a-f]{32}$"
-        },
-        "contactLocation": {
-          "description": "Contact location filters. Requires companyId.",
+        "insights": {
+          "description": "Insights filters. Supply at least one.",
           "type": "object",
           "properties": {
-            "countryCodes": {
-              "description": "Person or job location country codes.",
+            "monthlyOrganicTraffic": {
+              "description": "Monthly organic visits.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Lower bound, inclusive.",
+                  "type": "number",
+                  "minimum": 0
+                },
+                "max": {
+                  "description": "Upper bound, inclusive.",
+                  "type": "number",
+                  "minimum": 0
+                }
+              },
+              "additionalProperties": false
+            },
+            "monthlyPaidTraffic": {
+              "description": "Monthly paid visits.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Lower bound, inclusive.",
+                  "type": "number",
+                  "minimum": 0
+                },
+                "max": {
+                  "description": "Upper bound, inclusive.",
+                  "type": "number",
+                  "minimum": 0
+                }
+              },
+              "additionalProperties": false
+            },
+            "totalMonthlyTraffic": {
+              "description": "Monthly visits, organic and paid.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Lower bound, inclusive.",
+                  "type": "number",
+                  "minimum": 0
+                },
+                "max": {
+                  "description": "Upper bound, inclusive.",
+                  "type": "number",
+                  "minimum": 0
+                }
+              },
+              "additionalProperties": false
+            },
+            "monthlyGoogleAdSpendCents": {
+              "description": "Monthly Google ad spend, in cents.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Lower bound, inclusive, in cents.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Upper bound, inclusive, in cents.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "lastFundingAmountCents": {
+              "description": "Latest funding round amount, in cents.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Lower bound, inclusive, in cents.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Upper bound, inclusive, in cents.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "totalFundingAmountCents": {
+              "description": "Total funding raised, in cents.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Lower bound, inclusive, in cents.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Upper bound, inclusive, in cents.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "employeeGrowthRate": {
+              "description": "Employee growth rate, as reported in the release. Negative values include shrinking teams.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Lower bound, inclusive, for the reported growth rate.",
+                  "type": "number"
+                },
+                "max": {
+                  "description": "Upper bound, inclusive, for the reported growth rate.",
+                  "type": "number"
+                }
+              },
+              "additionalProperties": false
+            },
+            "accountExecutiveOpenRoles": {
+              "description": "Account executive open roles.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Maximum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "businessDevelopmentOpenRoles": {
+              "description": "Business development open roles.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Maximum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "customerSuccessOpenRoles": {
+              "description": "Customer success open roles.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Maximum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "demandGenerationOpenRoles": {
+              "description": "Demand generation open roles.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Maximum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "devopsOpenRoles": {
+              "description": "DevOps open roles.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Maximum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "grcOpenRoles": {
+              "description": "Governance, risk and compliance open roles.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Maximum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "itOpenRoles": {
+              "description": "IT open roles.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Maximum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "marketingOpenRoles": {
+              "description": "Marketing open roles.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Maximum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "networkInfrastructureOpenRoles": {
+              "description": "Network infrastructure open roles.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Maximum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "operationsOpenRoles": {
+              "description": "Operations open roles.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Maximum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "salesOpenRoles": {
+              "description": "Sales open roles.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Maximum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "securityOpenRoles": {
+              "description": "Security open roles.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "max": {
+                  "description": "Maximum open roles, inclusive.",
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "additionalProperties": false
+            },
+            "appStoreRating": {
+              "description": "Apple App Store rating, from 0 to 5.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum rating, inclusive, from 0 to 5.",
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 5
+                },
+                "max": {
+                  "description": "Maximum rating, inclusive, from 0 to 5.",
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 5
+                }
+              },
+              "additionalProperties": false
+            },
+            "playStoreRating": {
+              "description": "Google Play rating, from 0 to 5.",
+              "type": "object",
+              "properties": {
+                "min": {
+                  "description": "Minimum rating, inclusive, from 0 to 5.",
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 5
+                },
+                "max": {
+                  "description": "Maximum rating, inclusive, from 0 to 5.",
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 5
+                }
+              },
+              "additionalProperties": false
+            },
+            "crmTechnology": {
+              "description": "CRM product names. Match any reported product, ignoring case and surrounding spaces.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "excludeCrmTechnology": {
+              "description": "Exclude CRM product names. Companies with no reported product remain included.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "marketingAutomationTechnology": {
+              "description": "Marketing automation product names. Match any reported product, ignoring case and surrounding spaces.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "excludeMarketingAutomationTechnology": {
+              "description": "Exclude Marketing automation product names. Companies with no reported product remain included.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "abmTechnology": {
+              "description": "ABM product names. Match any reported product, ignoring case and surrounding spaces.",
               "minItems": 1,
-              "maxItems": 50,
+              "maxItems": 100,
               "type": "array",
               "items": {
                 "type": "string",
-                "pattern": "^\\s*[a-z]{2}\\s*$"
+                "minLength": 1,
+                "maxLength": 200
               }
             },
-            "stateCodes": {
-              "description": "Person or job location state codes.",
+            "excludeAbmTechnology": {
+              "description": "Exclude ABM product names. Companies with no reported product remain included.",
               "minItems": 1,
-              "maxItems": 50,
+              "maxItems": 100,
               "type": "array",
               "items": {
                 "type": "string",
                 "minLength": 1,
-                "maxLength": 120,
-                "pattern": "\\S"
+                "maxLength": 200
               }
             },
-            "cities": {
-              "description": "Person or job location cities.",
+            "salesAutomationTechnology": {
+              "description": "Sales automation product names. Match any reported product, ignoring case and surrounding spaces.",
               "minItems": 1,
-              "maxItems": 50,
+              "maxItems": 100,
               "type": "array",
               "items": {
                 "type": "string",
                 "minLength": 1,
-                "maxLength": 120,
-                "pattern": "\\S"
+                "maxLength": 200
+              }
+            },
+            "excludeSalesAutomationTechnology": {
+              "description": "Exclude Sales automation product names. Companies with no reported product remain included.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "analyticsTechnology": {
+              "description": "Analytics product names. Match any reported product, ignoring case and surrounding spaces.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "excludeAnalyticsTechnology": {
+              "description": "Exclude Analytics product names. Companies with no reported product remain included.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "cmsTechnology": {
+              "description": "CMS product names. Match any reported product, ignoring case and surrounding spaces.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "excludeCmsTechnology": {
+              "description": "Exclude CMS product names. Companies with no reported product remain included.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "cloudProviderTechnology": {
+              "description": "Cloud provider product names. Match any reported product, ignoring case and surrounding spaces.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "excludeCloudProviderTechnology": {
+              "description": "Exclude Cloud provider product names. Companies with no reported product remain included.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "ecommerceTechnology": {
+              "description": "Ecommerce product names. Match any reported product, ignoring case and surrounding spaces.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "excludeEcommerceTechnology": {
+              "description": "Exclude Ecommerce product names. Companies with no reported product remain included.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "erpTechnology": {
+              "description": "ERP product names. Match any reported product, ignoring case and surrounding spaces.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "excludeErpTechnology": {
+              "description": "Exclude ERP product names. Companies with no reported product remain included.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "applicationSecurityTechnology": {
+              "description": "Application security product names. Match any reported product, ignoring case and surrounding spaces.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "excludeApplicationSecurityTechnology": {
+              "description": "Exclude Application security product names. Companies with no reported product remain included.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "cloudSecurityTechnology": {
+              "description": "Cloud security product names. Match any reported product, ignoring case and surrounding spaces.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "excludeCloudSecurityTechnology": {
+              "description": "Exclude Cloud security product names. Companies with no reported product remain included.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "emailSecurityTechnology": {
+              "description": "Email security product names. Match any reported product, ignoring case and surrounding spaces.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "excludeEmailSecurityTechnology": {
+              "description": "Exclude Email security product names. Companies with no reported product remain included.",
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "technologyPresent": {
+              "description": "Technology categories the company must have.",
+              "minItems": 1,
+              "maxItems": 10,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "crm",
+                  "marketingAutomation",
+                  "abm",
+                  "salesAutomation",
+                  "analytics",
+                  "cms",
+                  "cloudProvider",
+                  "ecommerce",
+                  "erp",
+                  "security"
+                ]
               }
             }
           },
           "additionalProperties": false
-        },
-        "excludeListId": {
-          "description": "Saved list whose members are left out of the result.",
-          "type": "string",
-          "format": "uuid",
-          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
         }
       },
       "additionalProperties": false
@@ -10988,7 +12895,7 @@ var TOOL_CATALOG = [
                       }
                     },
                     "personNames": {
-                      "description": "Person name alternatives. Requires a company name, domain or id. Matches first or last name for one token, or first and last name for two tokens, ignoring case and accents.",
+                      "description": "Person name alternatives. Add a company name, domain or id for common names and typo matching. Every non-particle token matches in any order, ignoring case, accents and punctuation. Scoped searches allow one edit per token of at least five letters.",
                       "minItems": 1,
                       "maxItems": 5,
                       "type": "array",
@@ -11356,6 +13263,28 @@ var TOOL_CATALOG = [
                         "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                       }
                     },
+                    "sort": {
+                      "description": "Sort by primary company employee estimate, largest or smallest first. Unknown sizes come last. Available from the November 2026 release.",
+                      "type": "string",
+                      "enum": [
+                        "company_size_desc",
+                        "company_size_asc"
+                      ]
+                    },
+                    "firstName": {
+                      "description": "First name tokens, using accent-folded fuzzy matching. Requires companyId.",
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 120,
+                      "pattern": "\\S"
+                    },
+                    "lastName": {
+                      "description": "Last name tokens, using accent-folded fuzzy matching. Requires companyId.",
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 120,
+                      "pattern": "\\S"
+                    },
                     "companyId": {
                       "description": "Limit contacts to this company. This uses the company-indexed contact path and does not require country or industry filters.",
                       "type": "string",
@@ -11781,23 +13710,35 @@ var TOOL_CATALOG = [
 
 // src/transport.ts
 import { z } from "zod";
-var failure = z.object({ error: z.union([z.string(), z.object({ code: z.string().max(128), message: z.string().max(2048).optional(), retry_after: z.number().nonnegative().finite().optional() })]) });
+var failure = z.object({ error: z.union([z.string(), z.object({ code: z.string().max(128), message: z.string().max(2048).optional(), billing_href: z.string().max(2048).optional(), retry_after: z.number().nonnegative().finite().optional() })]) });
 var HigherDataError = class extends Error {
-  constructor(message, code, status = 0, retryAfter2, requestId) {
+  constructor(message, code, status = 0, retryAfter2, requestId, billingHref) {
     super(message);
     this.code = code;
     this.status = status;
     this.retryAfter = retryAfter2;
     this.requestId = requestId;
+    this.billingHref = billingHref;
     this.name = "HigherDataError";
   }
   code;
   status;
   retryAfter;
   requestId;
+  billingHref;
 };
 var limits = z.object({ maxRetries: z.number().int().min(0).max(5), timeoutMs: z.number().int().min(1).max(3e5), maxRetryDelayMs: z.number().int().min(0).max(3e5) });
 var MAX_RESPONSE = 8 * 1024 * 1024;
+var DOWNLOAD_PAGE_ROWS = 500;
+var INTERACTIVE_PAGE_ROWS = 50;
+function responseByteLimit(path, input) {
+  const name = path.split("?")[0]?.split("/").at(-1);
+  if (name !== "search.companies" && name !== "search.people") return MAX_RESPONSE;
+  if (!input || typeof input !== "object" || Array.isArray(input) || input.download !== true) return MAX_RESPONSE;
+  const limit = input.limit;
+  const rows = typeof limit === "number" && Number.isInteger(limit) && limit >= 1 ? Math.min(limit, DOWNLOAD_PAGE_ROWS) : INTERACTIVE_PAGE_ROWS;
+  return MAX_RESPONSE * Math.ceil(rows / INTERACTIVE_PAGE_ROWS);
+}
 function retryAfter(response, data, now) {
   const value = response.headers.get("retry-after");
   if (value !== null) {
@@ -11814,9 +13755,9 @@ function retryAfter(response, data, now) {
 }
 function apiError(response, data, now) {
   const parsed = failure.safeParse(data), error = parsed.success ? parsed.data.error : null;
-  return new HigherDataError(typeof error === "object" && error?.message ? error.message : "The HigherData API request failed.", typeof error === "string" ? error : error?.code ?? "http_error", response.status, retryAfter(response, data, now), response.headers.get("x-request-id") ?? void 0);
+  return new HigherDataError(typeof error === "object" && error?.message ? error.message : "The HigherData API request failed.", typeof error === "string" ? error : error?.code ?? "http_error", response.status, retryAfter(response, data, now), response.headers.get("x-request-id") ?? void 0, typeof error === "object" ? error?.billing_href : void 0);
 }
-async function responseJson(response) {
+async function responseJson(response, maxBytes) {
   if (!response.body) throw new HigherDataError("The API returned an invalid response.", "invalid_response");
   const reader = response.body.getReader(), chunks = [];
   let length = 0;
@@ -11825,7 +13766,7 @@ async function responseJson(response) {
       const { done, value } = await reader.read();
       if (done) break;
       length += value.byteLength;
-      if (length > MAX_RESPONSE) {
+      if (length > maxBytes) {
         await reader.cancel();
         throw new HigherDataError("The API response exceeded the size limit.", "response_too_large");
       }
@@ -11899,7 +13840,7 @@ var JsonTransport = class {
         const timeout = AbortSignal.timeout(options.timeoutMs ?? this.settings.timeoutMs);
         response = await (this.options.fetch ?? fetch)(url.toString(), { method: "POST", headers, body, redirect: "manual", signal: options.signal ? AbortSignal.any([timeout, options.signal]) : timeout });
         try {
-          data = await responseJson(response);
+          data = await responseJson(response, responseByteLimit(path, input));
         } catch (error2) {
           if (response.ok) throw error2;
           data = void 0;