メールアウトリーチディレクトリ

業界別に分類された最新のプレス連絡先メールアドレス。

99.9 % 稼働時間
918ms レスポンス
20 req/s
0.01 クレジット / リクエスト

List Press Releases


POST https://api.yeb.to/v1/outreach/list
パラメータ必須説明
api_key string はい Your API key
category string 任意 Filter by category (e.g. Technology, Healthcare & Pharma)
days integer 任意 Only show press releases from the last N days (0 = all time)
page integer 任意 Page number (default: 1)
per_page integer 任意 Results per page, max 100 (default: 20)

curl -X POST https://api.yeb.to/v1/outreach/list \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "category": "Technology",
  "days": 7,
  "page": 1,
  "per_page": 20
}'

レスポンス例

{
  "data": [
    {
      "id": 42581,
      "summary": "TechCorp announces new AI platform for enterprise automation",
      "category": "Technology",
      "added_at": "2026-03-11T08:30:00+00:00",
      "mails": [
        { "mail": "[email protected]", "unlocked": true },
        { "mail": "j***@reuters.com", "unlocked": false }
      ]
    }
  ],
  "total": 1842,
  "page": 1,
  "per_page": 20,
  "last_page": 93
}
{"error":"Invalid API key","code":401}

レスポンスコード

コード説明
200 Successリクエスト処理成功。
400 Bad Request入力バリデーション失敗。
401 UnauthorizedAPIキーが不足または不正。
403 Forbiddenキーが無効または許可されていません。
429 Rate Limitリクエストが多すぎます。
500 Server Error予期しないエラー。

List Press Releases

outreach/list 0.0100 credits

Parameters

API Key
body · string · required
Category
body · string
Days
body · string
Page
body · string
Per Page
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Unlock Emails


POST https://api.yeb.to/v1/outreach/unlock
パラメータ必須説明
api_key string はい Your API key
mails array はい Array of email addresses to unlock

curl -X POST https://api.yeb.to/v1/outreach/unlock \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "mails": ["[email protected]", "[email protected]"]
}'

レスポンス例

{
  "emails": ["[email protected]", "[email protected]"],
  "new_unlocked": 2,
  "already_unlocked": 0,
  "credits_charged": 2.0
}
{"error":"Insufficient credits. Need 2, have 0.5","code":402}

レスポンスコード

コード説明
200 Successリクエスト処理成功。
400 Bad Request入力バリデーション失敗。
401 UnauthorizedAPIキーが不足または不正。
403 Forbiddenキーが無効または許可されていません。
429 Rate Limitリクエストが多すぎます。
500 Server Error予期しないエラー。

Unlock Emails

outreach/unlock 1.0000 credits

Parameters

API Key
body · string · required
Emails
body · string · required

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

List Categories


POST https://api.yeb.to/v1/outreach/categories
パラメータ必須説明
api_key string はい Your API key

curl -X POST https://api.yeb.to/v1/outreach/categories \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY"
}'

レスポンス例

{
  "categories": [
    { "name": "Business & Finance", "count": 4521 },
    { "name": "Technology", "count": 3892 },
    { "name": "Healthcare & Pharma", "count": 2104 },
    { "name": "Entertainment & Media", "count": 1847 }
  ],
  "total": 15
}
{"error":"Invalid API key","code":401}

レスポンスコード

コード説明
200 Successリクエスト処理成功。
400 Bad Request入力バリデーション失敗。
401 UnauthorizedAPIキーが不足または不正。
403 Forbiddenキーが無効または許可されていません。
429 Rate Limitリクエストが多すぎます。
500 Server Error予期しないエラー。

List Categories

outreach/categories 0.0010 credits

Parameters

API Key
body · string · required

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Export Contacts


POST https://api.yeb.to/v1/outreach/export
パラメータ必須説明
api_key string はい Your API key
format string 任意 Export format: json or csv (default: json)
category string 任意 Filter exported contacts by category

curl -X POST https://api.yeb.to/v1/outreach/export \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "format": "json",
  "category": "Technology"
}'

レスポンス例

{
  "data": [
    {
      "email": "[email protected]",
      "category": "Technology",
      "summary": "TechCorp announces new AI platform",
      "added_at": "2026-03-11 08:30:00"
    },
    {
      "email": "[email protected]",
      "category": "Technology",
      "summary": "Reuters covers enterprise automation trend",
      "added_at": "2026-03-10 14:15:00"
    }
  ],
  "total": 2,
  "format": "json"
}
{"error":"Authentication required","code":401}

レスポンスコード

コード説明
200 Successリクエスト処理成功。
400 Bad Request入力バリデーション失敗。
401 UnauthorizedAPIキーが不足または不正。
403 Forbiddenキーが無効または許可されていません。
429 Rate Limitリクエストが多すぎます。
500 Server Error予期しないエラー。

Export Contacts

outreach/export 0.0500 credits

Parameters

API Key
body · string · required
Format
body · string
Category
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

よくある質問

各連絡先は、提携配信サービスでの有料プレスリリースまたはゲスト投稿注文から抽出されています。企業は既に配信に投資しており、積極的にメディア掲載を求めています。

新しいプレスリリースは複数の配信サービスから毎日収集されます。最新性(1日、7日、30日)でフィルタリングして、最新の連絡先のみを取得できます。

1クレジットで1件の新しいメールアドレスをロック解除します。既にロック解除済みのメールは再度無料でアクセスできます。リストおよびカテゴリエンドポイントはクレジットのごく一部です。

はい。エクスポートエンドポイントを使用して、ロック解除済みの全連絡先をJSONまたはCSVでダウンロードできます。カテゴリによるフィルタリングも可能です。

まだロック解除していないメールは部分的にマスクされています(例:j***@example.com)。ロック解除後は、以降のすべてのリクエストで完全なアドレスが返されます。

はい。エラーが発生したリクエストを含め、すべてのリクエストがクレジットを消費します。クレジットは成功・失敗に関係なくリクエスト数に紐づいています。エラーが明らかに当社のプラットフォーム側の問題による場合は、影響を受けたクレジットを復元します(現金での返金はありません)。

[email protected]までご連絡ください。フィードバックを真摯に受け止めています。バグレポートや機能リクエストが意味のあるものであれば、APIを迅速に修正・改善し、お礼として50の無料クレジットを付与します。

APIやエンドポイントによって異なります。一部のエンドポイントは外部ソースのデータを使用しており、より厳しい制限がある場合があります。また、不正利用の防止とプラットフォームの安定性維持のために制限を設けています。各エンドポイントの具体的な制限についてはドキュメントをご確認ください。

クレジットシステムで運営しています。クレジットは前払いの返金不可の単位で、API呼び出しやツールに使用します。クレジットはFIFO(古いものから順に)消費され、購入日から12か月間有効です。ダッシュボードに各購入日とその有効期限が表示されます。

はい。購入したすべてのクレジット(端数残高を含む)は購入から12か月間有効です。未使用のクレジットは有効期間終了時に自動的に期限切れとなり、永久に削除されます。期限切れのクレジットは復元や現金その他の価値への変換はできません。経過措置:2025年9月22日以前に購入したクレジットは2025年9月22日購入として扱われ、2026年9月22日に期限切れとなります(購入時により早い期限が記載されていない限り)。

はい—有効期間内で繰り越されます。未使用のクレジットは利用可能な状態のまま月ごとに繰り越され、購入後12か月で期限切れになります。

クレジットは返金不可です。必要な分だけ購入してください—後からいつでもチャージできます。プラットフォーム側のエラーで課金に失敗した場合、調査後に影響を受けたクレジットを復元する場合があります。現金での返金はありません。

料金はドルではなくクレジットで設定されています。各エンドポイントには独自のコストがあります—上記の「クレジット / リクエスト」バッジをご覧ください。常に正確な支出額がわかります。
← APIに戻る