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つ送信し、見つかったメールアドレスを読み取ります。
- {"url": "https://www.youtube.com/@mkbhd"} を /v1/youtube/channel-email に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。複数のページを調べるため、検索よりも少し時間がかかります。
- 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 を保存しておくと、連絡先がどこで公開されていたかを問われたときに示せます。
- 数週間後に再確認してください。クリエイターは説明文やリンクページを更新しますし、メールアドレスが見つからなかった照会は課金されません。
関連API
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 Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Trending Videos API