Find email addresses at a company domain, with roles

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
  --url 'https://api.aisa.one/apis/v1/hunter/companies-emails?limit=1' \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/hunter/companies-emails', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/hunter/companies-emails",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/hunter/companies-emails"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/hunter/companies-emails")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

GET

https://api.aisa.one

apis

hunter

companies-emails

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
  --url 'https://api.aisa.one/apis/v1/hunter/companies-emails?limit=1' \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/hunter/companies-emails', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/hunter/companies-emails",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/hunter/companies-emails"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/hunter/companies-emails")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

Request contract

Method and path: GET /apis/v1/hunter/companies-emails
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/hunter/companies-emails
aggregations: query; optional
company: query; optional
decision_maker: query; optional
department: query; optional
domain: query; optional
job_titles: query; optional
limit: query; required
location: query; optional
offset: query; optional
required_field: query; optional
seniority: query; optional
type: query; optional
verification_status: query; optional
Runtime facts: 9d6cd55f4883e0d802c7a28091c00738a9992688a6c242f0fae404a62c5146a1

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "hunter.companies-emails",
  "method": "GET",
  "path": "/apis/v1/hunter/companies-emails",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "name": "aggregations",
      "in": "query",
      "required": false,
      "schema": {
        "type": "boolean",
        "description": "return aggregate breakdowns (by department, seniority) alongside the results"
      }
    },
    {
      "name": "company",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "description": "company name, when you don't know the domain"
      }
    },
    {
      "name": "decision_maker",
      "in": "query",
      "required": false,
      "schema": {
        "type": "boolean",
        "description": "restrict to people Hunter classifies as decision makers"
      }
    },
    {
      "name": "department",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "description": "executive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations"
      }
    },
    {
      "name": "domain",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "description": "the company's domain — preferred over company",
        "examples": [
          "stripe.com"
        ]
      }
    },
    {
      "name": "job_titles",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "description": "comma-separated job titles to match"
      }
    },
    {
      "examples": {
        "default": {
          "value": 1
        },
        "minimal": {
          "value": 1
        }
      },
      "in": "query",
      "name": "limit",
      "required": true,
      "schema": {
        "maximum": 100,
        "minimum": 1,
        "type": "integer",
        "description": "emails to return, default 10, max 100 — THIS IS THE PRICE DIAL: 1 search credit per 10 returned"
      }
    },
    {
      "name": "location",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "description": "comma-separated locations to filter results by"
      }
    },
    {
      "name": "offset",
      "in": "query",
      "required": false,
      "schema": {
        "type": "integer",
        "description": "records to skip, for paging"
      }
    },
    {
      "name": "required_field",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "description": "comma-separated fields a result must have, e.g. full_name,position"
      }
    },
    {
      "name": "seniority",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "description": "junior, senior, executive — comma-separate to combine"
      }
    },
    {
      "name": "type",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "description": "personal (named people) | generic (info@, contact@)",
        "examples": [
          "personal"
        ]
      }
    },
    {
      "name": "verification_status",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "description": "filter by deliverability status, e.g. valid"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "response_units",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.0245,
    "estimate_source": "profile_seed",
    "evidence_source": "response_header",
    "unit": "provider_credit",
    "unit_rate_usd": 1e-06
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Usage-based billing; Default request estimate: $0.0245 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Default request reference estimate (USD): 0.0245
Declared unit rate (USD): 1e-06
Billing unit: provider_credit
Cost contract: response_units
Published reference multiplier: 1.0
Settlement evidence source: response_header

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

aggregations

boolean

return aggregate breakdowns (by department, seniority) alongside the results

company

string

company name, when you don't know the domain

decision_maker

boolean

restrict to people Hunter classifies as decision makers

department

string

executive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations

domain

string

the company's domain — preferred over company

Example:

"stripe.com"

job_titles

string

comma-separated job titles to match

limit

integer

required

emails to return, default 10, max 100 — THIS IS THE PRICE DIAL: 1 search credit per 10 returned

Required range: 1 <= x <= 100

location

string

comma-separated locations to filter results by

offset

integer

records to skip, for paging

required_field

string

comma-separated fields a result must have, e.g. full_name,position

seniority

string

junior, senior, executive — comma-separate to combine

type

string

personal (named people) | generic (info@, contact@)

Example:

"personal"

verification_status

string

filter by deliverability status, e.g. valid

Response

Successful response