# hunter.company.search

Companies by industry, headcount, location and keywords

> Returns companies matching a set of criteria.

Page: https://telipot.com/catalog/tasks/hunter.company.search · Markdown: https://telipot.com/catalog/tasks/hunter.company.search/md · JSON: https://telipot.com/catalog/tasks/hunter.company.search/json

| Field | Value |
| --- | --- |
| provider | [Hunter](https://telipot.com/catalog/providers/hunter) `hunter` |
| capability | [`company.search`](https://telipot.com/catalog/capabilities/company.search) |
| kind | data |
| tier | core |
| price | Free (Free from the tool) |
| identity | Your plan |
| auth | `api_key · in header as X-API-KEY` |
| scope | any_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `POST https://api.hunter.io/v2/discover` |
| verification | Not verified yet. Not checked yet. We test with a real request before we mark it. |
| status | live |
| docs | https://hunter.io/api-documentation/v2#discover |

## Preview the price · nothing runs

```bash
telipot run hunter.company.search \
  --input-json '{"organization":{"domain":["stripe.com"]}}' \
  --quote
```

## Run it

```bash
telipot run hunter.company.search \
  --input-json '{"organization":{"domain":["stripe.com"]}}'
```

```bash
curl https://api.telipot.com/v1/tasks/hunter.company.search/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"organization":{"domain":["stripe.com"]}}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `query` | body | string | no | at most 2000 | Plain-language description; Hunter's AI assistant picks the filters and returns them in meta.filters, which are better to reuse than the sentence when paging. Required unless a filter is given. |
| `organization` | body | object | no |  | { domain: [..], name: [..] }. Lists of domains and company names to select; when both are given the results combine into one set of domains. |
| `headquarters_location` | body | object | no |  | { include: [..], exclude: [..] }, each location one of continent (Europe, Asia, North America, Africa, Antarctica, South America, Oceania), business_region (AMER, EMEA, APAC, LATAM), or country (ISO 3166-1 alpha-2) with optional state and city. A city needs a country; a US city needs a state. |
| `industry` | body | object | no |  | { include: [..], exclude: [..] } of names from https://hunter.io/files/industries.json. |
| `headcount` | body | array | no |  | Company size ranges to keep. One or more of 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. |
| `company_type` | body | object | no |  | { include: [..], exclude: [..] } of educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship. |
| `keywords` | body | object | no |  | { include: [..], exclude: [..], match: any\|all }, at most 100 keywords per list; match defaults to all. |
| `job_openings` | body | object | no |  | { hiring, department: [..], job_title: { include, exclude }, posted_date: last7d\|last30d\|last90d, open_roles: { from, to }, include_closed_roles }. Department values are case-sensitive; any field selects companies that are hiring. |
| `year_founded` | body | object | no |  | { include: [..], exclude: [..] } or { from, to }, four-digit years. Premium plan only. |
| `technology` | body | object | no |  | { include: [..], exclude: [..], match: any\|all } of slugs from https://hunter.io/files/technologies.json. Premium plan only. |
| `funding` | body | object | no |  | { series: [..], amount: { from, to }, date: { from, to } }; series is one or more of pre_seed, seed, pre_series_a, series_a, pre_series_b, series_b, pre_series_c, series_c+, other. Premium plan only. |
| `limit` | body | integer | no | 1 to 100; default 100 | Companies per page. Premium plan only; changing it on a Free plan returns 400 pagination_error. |
| `offset` | body | integer | no | 0 to 10000; default 0 | Companies to skip. Premium plan only; changing it on a Free plan returns 400 pagination_error. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Plain-language description; Hunter's AI assistant picks the filters and returns them in meta.filters, which are better to reuse than the sentence when paging. Required unless a filter is given.",
      "examples": [
        "Companies in Europe that specialize in software development"
      ],
      "maxLength": 2000
    },
    "organization": {
      "type": "object",
      "description": "{ domain: [..], name: [..] }. Lists of domains and company names to select; when both are given the results combine into one set of domains.",
      "examples": [
        {
          "domain": [
            "stripe.com"
          ]
        }
      ]
    },
    "headquarters_location": {
      "type": "object",
      "description": "{ include: [..], exclude: [..] }, each location one of continent (Europe, Asia, North America, Africa, Antarctica, South America, Oceania), business_region (AMER, EMEA, APAC, LATAM), or country (ISO 3166-1 alpha-2) with optional state and city. A city needs a country; a US city needs a state.",
      "examples": [
        {
          "include": [
            {
              "country": "FR",
              "city": "Paris"
            }
          ]
        }
      ]
    },
    "industry": {
      "type": "object",
      "description": "{ include: [..], exclude: [..] } of names from https://hunter.io/files/industries.json.",
      "examples": [
        {
          "include": [
            "Financial Services"
          ]
        }
      ]
    },
    "headcount": {
      "type": "array",
      "description": "Company size ranges to keep. One or more of 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.",
      "examples": [
        [
          "51-200",
          "201-500"
        ]
      ]
    },
    "company_type": {
      "type": "object",
      "description": "{ include: [..], exclude: [..] } of educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship.",
      "examples": [
        {
          "include": [
            "privately held"
          ]
        }
      ]
    },
    "keywords": {
      "type": "object",
      "description": "{ include: [..], exclude: [..], match: any|all }, at most 100 keywords per list; match defaults to all.",
      "examples": [
        {
          "include": [
            "payments"
          ],
          "match": "any"
        }
      ]
    },
    "job_openings": {
      "type": "object",
      "description": "{ hiring, department: [..], job_title: { include, exclude }, posted_date: last7d|last30d|last90d, open_roles: { from, to }, include_closed_roles }. Department values are case-sensitive; any field selects companies that are hiring.",
      "examples": [
        {
          "hiring": true,
          "department": [
            "engineering"
          ]
        }
      ]
    },
    "year_founded": {
      "type": "object",
      "description": "{ include: [..], exclude: [..] } or { from, to }, four-digit years. Premium plan only.",
      "examples": [
        {
          "from": 2015,
          "to": 2020
        }
      ]
    },
    "technology": {
      "type": "object",
      "description": "{ include: [..], exclude: [..], match: any|all } of slugs from https://hunter.io/files/technologies.json. Premium plan only.",
      "examples": [
        {
          "include": [
            "stripe"
          ],
          "match": "any"
        }
      ]
    },
    "funding": {
      "type": "object",
      "description": "{ series: [..], amount: { from, to }, date: { from, to } }; series is one or more of pre_seed, seed, pre_series_a, series_a, pre_series_b, series_b, pre_series_c, series_c+, other. Premium plan only.",
      "examples": [
        {
          "series": [
            "seed",
            "series_a"
          ]
        }
      ]
    },
    "limit": {
      "type": "integer",
      "description": "Companies per page. Premium plan only; changing it on a Free plan returns 400 pagination_error.",
      "default": 100,
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "description": "Companies to skip. Premium plan only; changing it on a Free plan returns 400 pagination_error.",
      "default": 0,
      "minimum": 0,
      "maximum": 10000
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "domain",
          "organization",
          "emails_count"
        ],
        "properties": {
          "domain": {
            "type": "string"
          },
          "organization": {
            "type": [
              "string",
              "null"
            ]
          },
          "emails_count": {
            "type": "object",
            "properties": {
              "personal": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "generic": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "total": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            }
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "industry": {
            "type": [
              "string",
              "null"
            ]
          },
          "technologies": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "state": {
            "type": [
              "string",
              "null"
            ]
          },
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "headcount": {
            "type": [
              "string",
              "null"
            ]
          },
          "company_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "year_founded": {
            "type": [
              "integer",
              "null"
            ]
          },
          "keywords": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "already_saved": {
            "type": "boolean"
          }
        }
      }
    },
    "meta": {
      "type": "object",
      "required": [
        "results",
        "limit",
        "offset"
      ],
      "properties": {
        "results": {
          "type": "integer"
        },
        "limit": {
          "type": "integer"
        },
        "offset": {
          "type": "integer"
        },
        "params": {
          "type": "object"
        },
        "filters": {
          "type": "object"
        },
        "permalink": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    }
  }
}
```

## Other tools for this job

- [`apollo.company.search`](https://telipot.com/catalog/tasks/apollo.company.search) · $0.0196 / call