Search companies with Hunter filters

Describe the company’s headquarters location and employee size in everyday words. Review matching company names, websites, recorded email counts and the search conditions actually used.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use Toolmu search-companies-hunter to find companies with supported structured criteria described in ordinary language. Reuse a working Toolmu connection or follow https://toolmu.com/SKILL.md to connect. Check current inputs, availability and credit ceiling, keeping all requests within my authorization and total budget. Ask for company requirements if none were supplied; at least one real selection filter is required. Prepare headquarters location and employee-size fields internally. Map employee size only to documented ranges; if my requested range is unsupported, show the actual supported ranges in ordinary words and ask which to use rather than silently broadening it. Use country/location codes only as documented. For additional industry or technology criteria use exact values from the official Hunter catalog, and never guess unsupported entries. Confirm unsupported conditions and funding units before applying them. Start with up to five companies on the first page and manage supported pagination only if I request more. Present actual applied filters, names, websites and source email counts, distinguishing this page’s entries from the overall match count and email counts from workforce size. Similar companies remain candidates, not proven competitors or qualified customers.

Task:
Use Hunter to find companies headquartered in [country or region] with [employee size, such as 11 to 50 people]. Start with up to 5 companies and show names, websites, actual search conditions and recorded email counts.

Paste into your connected AI's conversation.

Connection guide

Free

Hunter

Search companies with Hunter filters

Describe the company’s headquarters location and employee size in everyday words. Review matching company names, websites, recorded email counts and the search conditions actually used.

You receive

Review a page of matching companies with names, websites and counts of personal, general-purpose and total email addresses. The source also reports the applied conditions and overall match count.

Start with your task

Use Hunter to find companies headquartered in [country or region] with [employee size, such as 11 to 50 people]. Start with up to 5 companies and show names, websites, actual search conditions and recorded email counts.

What to know

Results reflect Hunter’s recorded company information. Important attributes need checking; records and email counts do not prove complete current coverage, employee numbers or whether mailboxes can receive mail.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
Company filters`body`	`object`	Optional	Supply at least one meaningful supported company filter, with optional limit and offset for pages.
Companies per page`body.limit`	`integer`	Optional	Optional integer from 1 to 100, default 100. The requested page may contain fewer companies. Minimum `1` Maximum `100`
Companies to skip`body.offset`	`integer`	Optional	Optional integer from 0 to 10000, default 0. Keep the selected filters when requesting another page. Minimum `0` Maximum `10000`
Funding criteria`body.funding`	`object`	Optional	Optional funding-series choices and amount/date ranges. Dates use YYYY-MM-DD; confirm the source amount units before supplying a financial range.
date`body.funding.date`	`object`	Optional
to`body.funding.date.to`	`string`	Optional	YYYY-MM-DD
from`body.funding.date.from`	`string`	Optional	YYYY-MM-DD
amount`body.funding.amount`	`object`	Optional
to`body.funding.amount.to`	`number`	Optional
from`body.funding.amount.from`	`number`	Optional
series`body.funding.series`	`array`	Optional
[]`body.funding.series[]`	`string`	—	Options `pre_seed, seed, pre_series_a, series_a, pre_series_b, series_b, pre_series_c, series_c+, other`
Industries`body.industry`	`object`	Optional	Include and/or exclude labels from Hunter’s supported industry list at https://hunter.io/files/industries.json.
exclude`body.industry.exclude`	`array`	Optional
[]`body.industry.exclude[]`	`string`	—	Minimum length `1`
include`body.industry.include`	`array`	Optional
[]`body.industry.include[]`	`string`	—	Minimum length `1`
Keyword criteria`body.keywords`	`object`	Optional	Include and/or exclude terms. match accepts any or all; the default is all. Keyword matching is separate from the industry label filter.
match`body.keywords.match`	`string`	Optional	Match on any or all of the listed values. Default 'all'. Options `any, all`
exclude`body.keywords.exclude`	`array`	Optional
[]`body.keywords.exclude[]`	`string`	—	Minimum length `1`
include`body.keywords.include`	`array`	Optional
[]`body.keywords.include[]`	`string`	—	Minimum length `1`
Employee ranges`body.headcount`	`array`	Optional	Select one or more supported company-size ranges, such as 11-50. These source size categories differ from returned address counts.
[]`body.headcount[]`	`string`	—	Options `1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+`
Similar-company reference`body.similar_to`	`object`	Optional	Provide one reference company domain or name. If both are supplied, the domain is used; similarity does not prove a competitive relationship.
name`body.similar_to.name`	`string`	Optional	Minimum length `1`
domain`body.similar_to.domain`	`string`	Optional	Minimum length `1`
Technology criteria`body.technology`	`object`	Optional	Use supported names from https://hunter.io/files/technologies.json in include/exclude. match is any or all, default all.
match`body.technology.match`	`string`	Optional	Match on any or all of the listed values. Default 'all'. Options `any, all`
exclude`body.technology.exclude`	`array`	Optional
[]`body.technology.exclude[]`	`string`	—	Minimum length `1`
include`body.technology.include`	`array`	Optional
[]`body.technology.include[]`	`string`	—	Minimum length `1`
Company types`body.company_type`	`object`	Optional	Include and/or exclude the supported source company-type values. These are directory categories, not a legal-registration check.
exclude`body.company_type.exclude`	`array`	Optional
[]`body.company_type.exclude[]`	`string`	—	Options `educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship`
include`body.company_type.include`	`array`	Optional
[]`body.company_type.include[]`	`string`	—	Options `educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship`
Specific company selection`body.organization`	`object`	Optional	Select domain and/or company-name lists. When both lists are supplied, the source combines their selections into a set of domains.
name`body.organization.name`	`array`	Optional
[]`body.organization.name[]`	`string`	—	Minimum length `1`
domain`body.organization.domain`	`array`	Optional
[]`body.organization.domain[]`	`string`	—	Minimum length `1`
Founding years`body.year_founded`	`object`	Optional	Use a from/to range or explicit include/exclude year lists; do not combine the range and list approaches.
to`body.year_founded.to`	`integer`	Optional	Minimum `-9007199254740991` Maximum `9007199254740991`
from`body.year_founded.from`	`integer`	Optional	Minimum `-9007199254740991` Maximum `9007199254740991`
exclude`body.year_founded.exclude`	`array`	Optional
[]`body.year_founded.exclude[]`	`integer`	—	Minimum `-9007199254740991` Maximum `9007199254740991`
include`body.year_founded.include`	`array`	Optional
[]`body.year_founded.include[]`	`integer`	—	Minimum `-9007199254740991` Maximum `9007199254740991`
Headquarters locations`body.headquarters_location`	`object`	Optional	Include and/or exclude locations using continent, business_region or country. Country is a two-letter ISO code; a city requires country, and state is a US state code used only with country US.
exclude`body.headquarters_location.exclude`	`array`	Optional
[]`body.headquarters_location.exclude[]`	`object`	—	A location: continent, business_region, or country (+ state/city).
city`body.headquarters_location.exclude[].city`	`string`	—
state`body.headquarters_location.exclude[].state`	`string`	—	US state code — only valid when country is 'US'.
country`body.headquarters_location.exclude[].country`	`string`	—	ISO 3166-1 alpha-2 country code, e.g. 'US'. Minimum length `2` Maximum length `2`
continent`body.headquarters_location.exclude[].continent`	`string`	—	Options `Africa, Antarctica, Asia, Europe, North America, Oceania, South America`
business_region`body.headquarters_location.exclude[].business_region`	`string`	—	Options `AMER, EMEA, APAC, LATAM`
include`body.headquarters_location.include`	`array`	Optional
[]`body.headquarters_location.include[]`	`object`	—	A location: continent, business_region, or country (+ state/city).
city`body.headquarters_location.include[].city`	`string`	—
state`body.headquarters_location.include[].state`	`string`	—	US state code — only valid when country is 'US'.
country`body.headquarters_location.include[].country`	`string`	—	ISO 3166-1 alpha-2 country code, e.g. 'US'. Minimum length `2` Maximum length `2`
continent`body.headquarters_location.include[].continent`	`string`	—	Options `Africa, Antarctica, Asia, Europe, North America, Oceania, South America`
business_region`body.headquarters_location.include[].business_region`	`string`	—	Options `AMER, EMEA, APAC, LATAM`

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 (organization, similar_to, headquarters_location, industry, headcount, company_type, year_founded, keywords, technology, funding)."
    }
  },
  "additionalProperties": false
}

Result schema

No fixed output contract is available. Field types reflect saved result evidence; individual responses can differ.

Result schema
Field / Path	Type	Meaning
Page of companies`result.data`	`array`	Company entries returned for this request. The page length is separate from the reported full match count.
Company name`result.data[].organization`	`string`	Company organization name reported by Hunter.
Company domain`result.data[].domain`	`string`	Domain associated with a returned company in the source record.
Address counts`result.data[].emails_count`	`object`	Source counts for the company domain, grouped as total, personal and generic. They are not a list of addresses or employee headcount.
Total address count`result.data[].emails_count.total`	`number`	Total indexed address count reported for this domain, without a current deliverability guarantee.
Personal address count`result.data[].emails_count.personal`	`number`	Count in the source’s personal category, not a count of unique people.
Generic address count`result.data[].emails_count.generic`	`number`	Count in the source’s generic address category.
Applied filters`result.meta.filters`	`object`	Filters the source applied to this request. Review them before interpreting or combining company pages.
Reported matching companies`result.meta.results`	`number`	Source-reported company match count for the full search, rather than only this page. It does not establish a complete current business census.

Additional notes

Start with the companies you need to review and turn that need into explicit criteria. For example, a shortlist of US-headquartered companies in the 11–50 employee range uses headquarters_location and headcount. Headquarters describes the company’s base, rather than every place where it operates.

Use an industry label when a business classification matters, and keywords when you want to narrow records by terms. Choose industry and technology values from Hunter’s supported lists. For keyword or technology selections, any broadens the choice to any listed term, while all requires all listed terms.

Keep the same selected filters when requesting another page, changing limit and offset as needed. Compare the returned filters with the request before combining pages. The reported match count describes the search as a whole; the returned company array describes the current page. Check the current inputs before execution. Current Tool inputs

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

It requests companies the source considers similar to the supplied company. Similarity does not establish a competitive relationship, purchase interest or fit for your needs. Review each candidate’s actual business before making that assessment.

Search companies with Hunter filters

Search companies with Hunter filters

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Replace the location and size

Confirm the supported choices

Check the companies and search scope

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Replace the location and size

Confirm the supported choices

Check the companies and search scope

Questions about this tool.

Does finding similar companies prove they are competitors or suitable customers?