Skip to content
telipot
telipot
Join the waitlistSign in

Companies by industry, headcount, location and keywords.

Returns companies matching a set of criteria.

Job company.search

Your AI asks

checks the price first
telipot run hunter.company.search \
  --input-json '{"organization":{"domain":["stripe.com"]}}' \
  --quote

Price

Free
Priced· before it runs

hunter.company.search

FreeYour plan

Whose account it uses

1The person asking
not needed
2Your company’s Hunter plan
Selected identity for this example
3Our account
not used

What it sends

{
  "organization": {"domain":["stripe.com"]}
}

Your Hunter login is added for you. Your AI never sees it.

What it costs

Free

no charge from the provider

Preview the price first. --quote runs nothing.

For developers · run it

Shell · runs the task on the named account

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

query

string · 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

object

{ domain: [..], name: [..] }. Lists of domains and company names to select; when both are given the results combine into one set of domains.

headquarters_location

object

{ 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

object

{ include: [..], exclude: [..] } of names from https://hunter.io/files/industries.json.

headcount

array

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

object

{ include: [..], exclude: [..] } of educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship.

keywords

object

{ include: [..], exclude: [..], match: any|all }, at most 100 keywords per list; match defaults to all.

job_openings

object

{ 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

object

{ include: [..], exclude: [..] } or { from, to }, four-digit years. Premium plan only.

technology

object

{ include: [..], exclude: [..], match: any|all } of slugs from https://hunter.io/files/technologies.json. Premium plan only.

funding

object

{ 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

integer · 1 to 100 · default 100

Companies per page. Premium plan only; changing it on a Free plan returns 400 pagination_error.

offset

integer · 0 to 10000 · default 0

Companies to skip. Premium plan only; changing it on a Free plan returns 400 pagination_error.

data

object[]

meta

object

Full output schema · JSONNested fields and constraints

Output JSON Schema

{
  "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"
          ]
        }
      }
    }
  }
}

A real answer

No example captured yet: one is recorded when telipot catalog verify passes.