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

Hunter

Find email addresses at a company domain, with roles

one of domain | company is required. Mapped to people.search because what it actually returns is a filtered list of PEOPLE at that company  按用量计费；默认请求预估费用：$0.0245 USD（不是固定价格）。声明的单位费率：每 provider_credit $0.000001 USD。最终费用以账户适用价格及实际结算为准。

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

请求规范

方法与路径: GET /apis/v1/hunter/companies-emails
可用状态: enabled
请求 URL 模板: https://api.aisa.one/apis/v1/hunter/companies-emails
aggregations: query; 可选
company: query; 可选
decision_maker: query; 可选
department: query; 可选
domain: query; 可选
job_titles: query; 可选
limit: query; 必填
location: query; 可选
offset: query; 可选
required_field: query; 可选
seniority: query; 可选
type: query; 可选
verification_status: query; 可选
Runtime 事实版本: 9d6cd55f4883e0d802c7a28091c00738a9992688a6c242f0fae404a62c5146a1

完整 OpenAPI 定义有效请求与价格声明（包括认证和引用的 schema）：

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

费用与请求规则

按用量计费；默认请求预估费用：$0.0245 USD（不是固定价格）。声明的单位费率：每 provider_credit $0.000001 USD。最终费用以账户适用价格及实际结算为准。公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。

默认请求参考估价（USD）: 0.0245
声明的单位费率（USD）: 1e-06
计费单位: provider_credit
计费依据: response_units
公开参考倍率: 1.0
结算证据来源: response_header

授权

Authorization

string

header

必填

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

查询参数

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

示例:

"stripe.com"

job_titles

string

comma-separated job titles to match

limit

integer

必填

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

必填范围: 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@)

示例:

"personal"

verification_status

string

filter by deliverability status, e.g. valid

响应

成功响应