{
  "url": "https://telipot.com/catalog/tasks/hunter.company.search",
  "id": "hunter.company.search",
  "name": "Companies by industry, headcount, location and keywords",
  "provider": {
    "slug": "hunter",
    "name": "Hunter"
  },
  "capability": "company.search",
  "platform": "company",
  "kind": "data",
  "tier": "core",
  "identity": "key",
  "identityLabel": "Your plan",
  "price": {
    "amount": "Free",
    "state": "free",
    "label": "Free",
    "detail": "Free from the tool",
    "type": "free"
  },
  "providers": 2,
  "retention": "standard",
  "runsOn": "free",
  "live": true,
  "summary": "Returns companies matching a set of criteria.",
  "method": "POST",
  "path": "/discover",
  "host": "https://api.hunter.io/v2",
  "docsUrl": "https://hunter.io/api-documentation/v2#discover",
  "auth": {
    "scheme": "api_key",
    "label": "api_key · in header as X-API-KEY",
    "short": "api_key · x-api-key"
  },
  "scope": "any_account",
  "principal": "organization",
  "requiredScopes": [],
  "verification": {
    "state": "none",
    "label": "Not verified yet",
    "detail": "Not checked yet. We test with a real request before we mark it."
  },
  "input": [
    {
      "name": "query",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [
        "at most 2000"
      ],
      "note": "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."
    },
    {
      "name": "organization",
      "location": "body",
      "type": "object",
      "required": false,
      "constraints": [],
      "note": "{ domain: [..], name: [..] }. Lists of domains and company names to select; when both are given the results combine into one set of domains."
    },
    {
      "name": "headquarters_location",
      "location": "body",
      "type": "object",
      "required": false,
      "constraints": [],
      "note": "{ 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."
    },
    {
      "name": "industry",
      "location": "body",
      "type": "object",
      "required": false,
      "constraints": [],
      "note": "{ include: [..], exclude: [..] } of names from https://hunter.io/files/industries.json."
    },
    {
      "name": "headcount",
      "location": "body",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "Company size ranges to keep. One or more of 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+."
    },
    {
      "name": "company_type",
      "location": "body",
      "type": "object",
      "required": false,
      "constraints": [],
      "note": "{ include: [..], exclude: [..] } of educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship."
    },
    {
      "name": "keywords",
      "location": "body",
      "type": "object",
      "required": false,
      "constraints": [],
      "note": "{ include: [..], exclude: [..], match: any|all }, at most 100 keywords per list; match defaults to all."
    },
    {
      "name": "job_openings",
      "location": "body",
      "type": "object",
      "required": false,
      "constraints": [],
      "note": "{ 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."
    },
    {
      "name": "year_founded",
      "location": "body",
      "type": "object",
      "required": false,
      "constraints": [],
      "note": "{ include: [..], exclude: [..] } or { from, to }, four-digit years. Premium plan only."
    },
    {
      "name": "technology",
      "location": "body",
      "type": "object",
      "required": false,
      "constraints": [],
      "note": "{ include: [..], exclude: [..], match: any|all } of slugs from https://hunter.io/files/technologies.json. Premium plan only."
    },
    {
      "name": "funding",
      "location": "body",
      "type": "object",
      "required": false,
      "constraints": [],
      "note": "{ 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."
    },
    {
      "name": "limit",
      "location": "body",
      "type": "integer",
      "required": false,
      "constraints": [
        "1 to 100",
        "default 100"
      ],
      "note": "Companies per page. Premium plan only; changing it on a Free plan returns 400 pagination_error."
    },
    {
      "name": "offset",
      "location": "body",
      "type": "integer",
      "required": false,
      "constraints": [
        "0 to 10000",
        "default 0"
      ],
      "note": "Companies to skip. Premium plan only; changing it on a Free plan returns 400 pagination_error."
    }
  ],
  "sampleInput": {
    "organization": {
      "domain": [
        "stripe.com"
      ]
    }
  },
  "inputSchema": {
    "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": [
    {
      "name": "data",
      "type": "object[]"
    },
    {
      "name": "meta",
      "type": "object"
    }
  ],
  "outputSchema": {
    "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"
            ]
          }
        }
      }
    }
  },
  "commands": {
    "mode": "run",
    "cli": "telipot run hunter.company.search \\\n  --input-json '{\"organization\":{\"domain\":[\"stripe.com\"]}}'",
    "http": "curl https://api.telipot.com/v1/tasks/hunter.company.search/run \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"organization\":{\"domain\":[\"stripe.com\"]}}'",
    "quote": "telipot run hunter.company.search \\\n  --input-json '{\"organization\":{\"domain\":[\"stripe.com\"]}}' \\\n  --quote"
  },
  "siblings": [
    {
      "id": "apollo.company.search",
      "name": "Companies by domain, size, location, funding, tech filters",
      "provider": {
        "slug": "apollo",
        "name": "Apollo"
      },
      "capability": "company.search",
      "platform": "company",
      "kind": "data",
      "tier": "core",
      "identity": "key",
      "identityLabel": "Your plan",
      "price": {
        "type": "per_call",
        "confidence": "documented",
        "source": "docs",
        "sourceUrl": "https://docs.apollo.io/docs/api-pricing",
        "checked": "2026-10-05",
        "note": "1 credit per page, up to 100 results per page; per_page does not change the charge.",
        "state": "paid",
        "label": "$0.0196 / call",
        "amount": "$0.0196",
        "unit": "call",
        "usdPerUnit": {
          "floor": 0.0196,
          "ceiling": 0.0196
        },
        "native": {
          "text": "1 credit per call",
          "figure": "1 credit",
          "per": "call",
          "currency": "credits"
        },
        "detail": "1 credit · docs"
      },
      "providers": 2,
      "retention": "standard",
      "runsOn": "byoc",
      "live": true
    }
  ]
}