View raw JSON
{
"type": "object",
"required": [],
"properties": {
"body": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Companies per page. Default and max 100."
},
"offset": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "Companies to skip. Max 10,000."
},
"funding": {
"type": "object",
"properties": {
"date": {
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "YYYY-MM-DD"
},
"from": {
"type": "string",
"description": "YYYY-MM-DD"
}
}
},
"amount": {
"type": "object",
"properties": {
"to": {
"type": "number"
},
"from": {
"type": "number"
}
}
},
"series": {
"type": "array",
"items": {
"enum": [
"pre_seed",
"seed",
"pre_series_a",
"series_a",
"pre_series_b",
"series_b",
"pre_series_c",
"series_c+",
"other"
],
"type": "string"
}
}
}
},
"industry": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"include": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
}
},
"description": "Industries to include/exclude. Valid values: https://hunter.io/files/industries.json"
},
"keywords": {
"type": "object",
"properties": {
"match": {
"enum": [
"any",
"all"
],
"type": "string",
"description": "Match on any or all of the listed values. Default 'all'."
},
"exclude": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"include": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
}
}
},
"headcount": {
"type": "array",
"items": {
"enum": [
"1-10",
"11-50",
"51-200",
"201-500",
"501-1000",
"1001-5000",
"5001-10000",
"10001+"
],
"type": "string"
},
"description": "Company size ranges to include."
},
"similar_to": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"domain": {
"type": "string",
"minLength": 1
}
},
"description": "Find companies similar to one domain or name (domain wins)."
},
"technology": {
"type": "object",
"properties": {
"match": {
"enum": [
"any",
"all"
],
"type": "string",
"description": "Match on any or all of the listed values. Default 'all'."
},
"exclude": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"include": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
}
},
"description": "Technologies in use. Valid values: https://hunter.io/files/technologies.json"
},
"company_type": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"enum": [
"educational",
"educational institution",
"government agency",
"non profit",
"partnership",
"privately held",
"public company",
"self employed",
"self owned",
"sole proprietorship"
],
"type": "string"
}
},
"include": {
"type": "array",
"items": {
"enum": [
"educational",
"educational institution",
"government agency",
"non profit",
"partnership",
"privately held",
"public company",
"self employed",
"self owned",
"sole proprietorship"
],
"type": "string"
}
}
}
},
"organization": {
"type": "object",
"properties": {
"name": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"domain": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
}
},
"description": "Select specific companies by domain or name."
},
"year_founded": {
"type": "object",
"properties": {
"to": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"from": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"exclude": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"include": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
}
},
"description": "Founding years: a from/to range, or explicit years to include/exclude (not both)."
},
"headquarters_location": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"state": {
"type": "string",
"description": "US state code — only valid when country is 'US'."
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2 country code, e.g. 'US'."
},
"continent": {
"enum": [
"Africa",
"Antarctica",
"Asia",
"Europe",
"North America",
"Oceania",
"South America"
],
"type": "string"
},
"business_region": {
"enum": [
"AMER",
"EMEA",
"APAC",
"LATAM"
],
"type": "string"
}
},
"description": "A location: continent, business_region, or country (+ state/city)."
}
},
"include": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"state": {
"type": "string",
"description": "US state code — only valid when country is 'US'."
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2 country code, e.g. 'US'."
},
"continent": {
"enum": [
"Africa",
"Antarctica",
"Asia",
"Europe",
"North America",
"Oceania",
"South America"
],
"type": "string"
},
"business_region": {
"enum": [
"AMER",
"EMEA",
"APAC",
"LATAM"
],
"type": "string"
}
},
"description": "A location: continent, business_region, or country (+ state/city)."
}
}
},
"description": "Headquarters locations to include and/or exclude."
}
},
"description": "Provide at least one filter — the same filter set as the company discovery endpoint."
}
},
"additionalProperties": false
}