youtube/
channel-email

クリエイターやインフルエンサーへのアウトリーチ向けに、YouTubeチャンネルが公開しているビジネス用メールアドレスを探し、各アドレスを掲載ページとあわせて返します。クレジットはメールアドレスが見つかった場合にのみ消費されます。

YouTube Email Finder API

チャンネルURLで入力
アドレスごとに掲載ページ
見つかった場合のみ課金
結果1件あたり15クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

YouTube Email Finder

クリエイターの多くはスポンサーやコラボの依頼用にビジネス用メールアドレスを公開しており、チャンネルの説明文、連携しているSNSのプロフィール、リンクまとめページ、自身のウェブサイトなどに記載しています。それらのアドレスを掲載元のページとあわせて整理すれば、アウトリーチ担当者は確認可能な連絡先リストを手にでき、各アドレスがどこで公開されていたかも明確になります。

YouTube Email Finder API の主な機能

  • クリエイターが連絡先を載せる場所を確認チャンネルを起点に、説明文、連携しているSNSのプロフィール、リンクまとめ(link-in-bio)ページ、クリエイター自身のウェブサイトを順にたどります。
  • すべてのアドレスに掲載元emails には各アドレスが1回ずつ並び、source_urls にはそのアドレスが見つかった公開ページが入ります。
  • ハンドルとチャンネルIDのどちらのリンクにも対応同じチャンネルを指していれば、youtube.com/@handle と youtube.com/channel/UC... のどちらのリンクも受け付けます。
  • 見つかった場合のみ課金公開メールアドレスが1つ以上見つかったチャンネルは1件の結果を返し、見つからなかったチャンネルは空の結果で完了して課金されません。

YouTube Email Finder API のパラメータ

パラメータ必須説明
url必須チャンネルのリンクです。https://www.youtube.com/@handle または https://www.youtube.com/channel/UC... の形式で指定します。

YouTube Email Finder API の使い方

チャンネルリンクを1つ送信し、見つかったメールアドレスを読み取ります。

  1. {"url": "https://www.youtube.com/@mkbhd"} を /v1/youtube/channel-email に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。複数のページを調べるため、検索よりも少し時間がかかります。
  3. results.items を読み取ります。アドレスが見つかった場合は emails 一覧を持つ1件のレコードが、チャンネルが公開していない場合は空の一覧が返ります。
curl -X POST "https://api.socq.ai/v1/youtube/channel-email" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/@mkbhd"}'

# A found channel returns one item with emails[].email and emails[].source_urls.

YouTube Email Finder API の主なユースケース

  • アウトリーチリストの作成: クリエイター候補リストのチャンネルを順に調べ、メールアドレスが見つかったものをスポンサーやコラボの提案用に残します。
  • 提案を適切な窓口に送る: source_urls を見れば、チャンネル自身の連絡先と、マネジメントや事務所のページに載っているアドレスを見分けられます。
  • クリエイターデータベースの充実: 見つかったメールアドレスと掲載元を、YouTube Channels で取得した既存のチャンネルレコードに追加します。

YouTube Email Finder API 活用のヒント

  • まず YouTube Channel Search で候補チャンネルを集め、条件に合うチャンネルだけメールアドレスを調べてください。
  • 各アドレスと一緒に source_urls を保存しておくと、連絡先がどこで公開されていたかを問われたときに示せます。
  • 数週間後に再確認してください。クリエイターは説明文やリンクページを更新しますし、メールアドレスが見つからなかった照会は課金されません。

YouTube Email Finder API 以外に別の種類の公開YouTubeデータが必要な場合は、これらのAPIをご利用ください。

  • YouTube Channel Videos API — チャンネルURLから、ショートとライブ配信を除く通常の公開動画を取得します。
  • YouTube Comments API — 公開コメント、投稿者、エンゲージメント、元の動画、会話の情報を取得します。
  • YouTube Transcripts API — 取得可能なプレーンテキストの文字起こしを取得します。言語は任意で指定できます。
  • YouTube Channels API — 公開チャンネルのアカウント情報、画像、認証状態、表示中のオーディエンス統計を取得します。
  • YouTube Videos API — 既知の動画またはショートのURLから、メタデータ、サムネイル、再生時間、エンゲージメントを取得します。
  • YouTube Community Posts API — チャンネルURLから、コミュニティタブの公開投稿を、テキスト、チャンネル情報、タイムスタンプ、画像の参照、取得元の情報とともに取得します。

他のプラットフォームを見る

YouTubeのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

YouTube Email Finder API — よくある質問

YouTube Email Finder APIは、チャンネルのURLから、YouTubeクリエイターが公開しているビジネス用メールアドレスを探すためのプログラムインターフェースです。各メールアドレスを、それが見つかった公開ページとあわせて返します。

クリエイター自身が公開している場所です。チャンネルの説明文、連携しているSNSのプロフィール、リンクまとめページ、クリエイターのウェブサイトが対象で、各アドレスの掲載ページは source_urls に一覧で入ります。

タスクは空の結果で正常に完了し、課金されません。

クリエイターが公開を選んだ連絡先で、クリエイター本人のこともあれば、マネジメントや事務所のこともあります。source_urls から判断できます。

チャンネルのリンクをこのAPIに送信してください。チャンネルの説明文、連携しているSNSのプロフィール、リンクまとめページ、クリエイターのウェブサイトを確認し、公開されているアドレスを掲載ページとあわせて返します。

メールアドレスが1つ以上見つかった場合はチャンネル1件につき15クレジットで、見つからなかった場合は無料です。