email-finder-hunter

Hunter - メールインテリジェンス

セットアップ

認証情報を ~/.gooseworks/credentials.json から読み込みます：

export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")

~/.gooseworks/credentials.json が存在しない場合は、ユーザーに npx gooseworks login を実行するよう伝えてください。

すべてのエンドポイントで Bearer 認証を使用します：-H "Authorization: Bearer $GOOSEWORKS_API_KEY"

メールアドレスの検索と配信可能性の確認、および企業の発見ができます。

機能

• 統合エンリッチメント：メールアドレスから人物と企業の両方の情報を1回のリクエストで取得します
• メールエンリッチメント：メールアドレスから人物の詳細情報（氏名、所在地、職歴、ソーシャルプロフィール）を取得します
• メール件数：ドメインで取得できるメールアドレスの件数を、部門と役職レベル別に確認します
• 企業の発見：フィルターまたは自然言語を使って条件に合う企業を検索します
• 企業エンリッチメント：ドメインから企業の詳細情報（業界、説明、所在地、規模、技術スタック、資金調達）を取得します
• ドメイン検索：ドメインに属するすべてのメールアドレスを検索します
• メールアドレス検索：氏名と企業ドメインから、その人物の可能性が最も高いメールアドレスを検索します
• メールアドレス検証：メールアドレスにメールを配信できるか確認します

使用方法

統合エンリッチメント

メールアドレスから人物と企業の両方の情報を1回のリクエストで取得します。

パラメーター：

• email*（string）- エンリッチメント対象のメールアドレス

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/combined/find","query":{"email":"[email protected]"}}'

メールエンリッチメント

メールアドレスから人物の詳細情報（氏名、所在地、職歴、ソーシャルプロフィール）を取得します。

パラメーター：

• email（string）- エンリッチメント対象のメールアドレス
• linkedin_handle（string）- エンリッチメント対象の LinkedIn ハンドル

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/people/find","query":{"email":"[email protected]"}}'

メール件数

ドメインで取得できるメールアドレスの件数を、部門と役職レベル別に確認します。無料のエンドポイントです。

パラメーター：

• domain（string）- メールアドレスの件数を調べるドメイン
• company（string）- 企業名（ドメインを推奨）
• type（string）- フィルター：personal または generic

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/email-count","query":{"domain":"google.com"}}'

企業の発見

フィルターまたは自然言語を使って条件に合う企業を検索します。1回のリクエストで最大100社を返します。無料のエンドポイントです。

パラメーター：

• query（string）- 自然言語による検索（例：ヨーロッパのテック企業）
• headquarters_location（object）- 本社所在地によるフィルター
• industry（object）- 業界によるフィルター
• headcount（array）- 従業員数の範囲によるフィルター
• limit（integer）- 最大結果数（デフォルトは100）
• offset（integer）- ページネーション用にスキップする結果数

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/discover","body":{"query":"AI startups in San Francisco"}}'

企業エンリッチメント

ドメインから企業の詳細情報（業界、説明、所在地、規模、技術スタック、資金調達）を取得します。

パラメーター：

• domain*（string）- エンリッチメント対象の企業ドメイン（例：hunter.io）

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/companies/find","query":{"domain":"anthropic.com"}}'

ドメイン検索

ドメインに属するすべてのメールアドレスを検索します。メールアドレスとともに、情報源、信頼度スコア、検証ステータスを返します。

パラメーター：

• domain*（string）- 検索対象のドメイン（例：stripe.com）
• limit（integer）- 返すメールアドレスの最大数（デフォルトは10）
• offset（integer）- スキップするメールアドレス数
• type（string）- フィルター：personal または generic
• seniority（string）- フィルター：junior、senior、または executive
• department（string）- 部門によるフィルター（sales、marketing など）

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/domain-search","query":{"domain":"stripe.com"}}'

メールアドレス検索

氏名と企業ドメインから、その人物の可能性が最も高いメールアドレスを検索します。

パラメーター：

• domain（string）- 企業ドメイン（例：reddit.com）
• company（string）- 企業名（ドメインを推奨）
• first_name（string）- 人物の名
• last_name（string）- 人物の姓
• full_name（string）- フルネーム（名と姓が不明な場合）
• linkedin_handle（string）- LinkedIn プロフィールのハンドル

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/email-finder","query":{"domain":"openai.com","first_name":"Sam","last_name":"Altman"}}'

メールアドレス検証

メールアドレスにメールを配信できるか確認します。ステータス（valid、invalid、accept_all、webmail、disposable、unknown）を返します。

パラメーター：

• email*（string）- 検証対象のメールアドレス

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/email-verifier","query":{"email":"[email protected]"}}'

ユースケース

1. 営業アプローチ：ターゲット企業の確認済みメールアドレスを検索します
2. リード獲得：ドメインごとにメールアドレスのリストを作成します
3. メールアドレスの検証：キャンペーン前にリストを整理します
4. 企業調査：条件に一致する企業を検索します
5. 連絡先情報の拡充：メールアドレスから詳細なプロフィールを取得します

詳細を見る

エンドポイントの詳細とパラメーターについては、以下をご覧ください。

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/search \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"hunter API endpoints"}' List all endpoints
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/details \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/combined/find"}'   # Get endpoint details