インフルエンサーへのアウトリーチは、いつも同じ3つのステップでつまずきます。連絡先のアドレスを見つけること、1つのプロフィールをそのクリエイターのほかのアカウントと結び付けること、そして誰かがコンテンツを確認する前に、長いリストをオーディエンスとの適合度で絞り込むことです。どのステップも、たいていはプロフィール文、リンクインバイオのページ、Webサイトを行き来する手作業になります。
2026-11-17、SocQは各ステップに1つずつエンドポイントを用意したCreatorプラットフォームを公開しました。3つとも、公開プロフィールのURLを1件受け取ります。このガイドでは、各エンドポイントが返すデータ、リクエストの形、料金、使いどころを説明します。
結論:
POST /v1/creator/find-emails、/find-social-profiles、/age-genderのいずれかに、urlでプロフィールURLを1件送信します。GET /v1/tasks/{task_id}をポーリングし、data.results.itemsを読み取ります。返されるのは、見つかったページ付きのメールアドレス、信頼度スコア付きの関連アカウント、または年齢の範囲と性別の推定値です。
新しく追加されたCreatorエンドポイント
1 SocQクレジット = $0.005です。
| エンドポイント | 返すデータ | 入力できるSNS | 料金 |
|---|---|---|---|
| Influencer Email Finder API | クリエイターが公開しているビジネス用メールアドレス。それぞれに見つかったページが付く | Instagram、TikTok、YouTube、X、Facebook | 1件以上見つかった場合は8クレジット($0.04)、見つからなかった場合は0.5クレジット($0.0025) |
| Social Media Profile Finder API | クリエイターがほかのSNSで運営しているアカウントごとに1行。0〜1の信頼度と根拠を含む | Instagram、TikTok、YouTube、X、Facebook | 1回の照会につき8クレジット($0.04) |
| Age and Gender Detection API | プロフィール写真から推定した年齢の範囲と性別。信頼度スコアを含む | Instagram、TikTok、YouTube、X、Threads | 1回の照会につき1クレジット($0.005) |
3つとも、存在しないプロフィールの場合はタスクが失敗し、返金されます。
認証と非同期タスクの流れ
SocQのすべてのリクエストはAPIキーで認証し、送信、タスクのステータス確認、結果の取得のいずれでも同じヘッダーを使います。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
すべての収集処理はバックグラウンドタスクとして実行されます。
submit -> task_id -> queued -> running -> succeeded
\-> failed
送信時のレスポンスにはdata.task_idとdata.statusが含まれます。そのIDでタスクをポーリングします。
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
statusがsucceededになると、レスポンスのdata.results.itemsに正規化されたレコードの最初のページが含まれます。limitのデフォルトは50で、最大500まで指定できます。has_moreがtrueの場合は、results.next_cursorをcursorとして渡します。タスクがqueued、running、failedの間、エンドポイントはresultsを含まないタスクのメタデータを返します。
送信ボディに省略可能なcallback_urlを指定すると、タスクの完了時にSocQがタスクの概要をPOSTで1回送信します。レコードはGET /v1/tasks/{task_id}で読み取ってください。クライアント側でタイムアウトしてもタスクはキャンセルされないため、重複したタスクに支払うのではなく、同じタスクIDで照会を再開してください。402はクレジット不足を、429はキーがレートまたはクレジットの上限に達したことを意味します。
Influencer Email Finder API:取得元付きの公開ビジネス用メールアドレス
Influencer Email Finder APIは、クリエイターが公開しているメールアドレスを、プロフィール文、リンクインバイオのページの先、リンクされたWebサイト、ほかのSNSにあるクリエイターのアカウントから探します。urlには、Instagram、TikTok、YouTube、X、FacebookのいずれかのプロフィールURLを1件指定します。YouTubeチャンネルは@ハンドルまたはチャンネルIDでも指定できます。
curl -X POST "https://api.socq.ai/v1/creator/find-emails" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.instagram.com/miguelangeles"
}'
1件以上のメールアドレスが見つかると、結果はusername、name、emailsを含む1行になります。emailsの各エントリには、emailと、そのアドレスが見つかった公開ページであるsource_urlsが含まれます。
{
"id": "instagram:miguelangeles",
"username": "miguelangeles",
"emails": [
{
"email": "mgmt@irlangel.com",
"source_urls": [
"https://www.instagram.com/miguelangeles",
"https://www.youtube.com/@miguelangeles"
]
}
]
}
取得元があることで、アウトリーチ担当者はアドレスを使う前にその出どころを確認でき、クリエイター自身の複数のページに掲載されているアドレスを優先できます。メールアドレスが見つからなかった場合も、タスクは成功となり、行は返されず、0.5クレジットがかかります。ドキュメント:Influencer Email Finder。
Social Media Profile Finder API:ほかのSNSにいる同じクリエイター
Instagramで知ったクリエイターのTikTokやYouTubeも知りたい場合は、Social Media Profile Finder APIに手元のプロフィールを渡すと、同じ人物について見つかったほかのアカウントを1件につき1行で返します。送信したプロフィール自体は結果に含まれません。
curl -X POST "https://api.socq.ai/v1/creator/find-social-profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.instagram.com/miguelangeles"
}'
各行には、関連アカウントのurl、network、username、0〜1のconfidence、そしてevidence(アカウント同士を結び付けるシグナル。same_handle、website_link、reciprocal_profile_linkなど)が含まれます。source_networkとsource_urlには照会したプロフィールが繰り返し入ります。confidenceとevidenceで絞り込み、信頼できる一致だけを残してください。1回の照会は、見つかったアカウントの数にかかわらず8クレジットです。ドキュメント:Social Media Profile Finder。
Age and Gender Detection API:プロフィール写真による属性フィルター
Age and Gender Detection APIを使うと、コンテンツの確認に時間をかける前に、クリエイターのリストを属性で振り分けられます。推定はプロフィール写真に写った顔から行われます。Instagram、TikTok、YouTube、X、ThreadsのいずれかのプロフィールURLを1件指定します。
curl -X POST "https://api.socq.ai/v1/creator/age-gender" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://x.com/levelsio"
}'
行には、network、username、age_minとage_max(推定される年齢の範囲、単位は年)、gender(maleまたはfemale)、0〜100のgender_confidenceが含まれます。顔がはっきり写った個人アカウントで最も精度が高くなり、ロゴや集合写真の場合は年齢と性別のフィールドが空になります。出力はその人物に関する確認済みの事実ではなく、写真からの推定として扱ってください。ドキュメント:Age and Gender Detection。
3つを組み合わせる
クリエイターのプロフィールURLのリストに対する、典型的なアウトリーチのパイプラインは次のとおりです。
- 絞り込み:プロフィール1件あたり1クレジットのAge and Gender Detectionを使い、推定値がキャンペーンに合うクリエイターを残します。
- 拡張:候補に残った各クリエイターについてSocial Media Profile Finderでほかのアカウントを集め、信頼度のしきい値を超える一致を残します。
- 連絡:Influencer Email Finderを使い、各メールアドレスを
source_urlsとともに保存します。
候補のクリエイターが100人の場合、ステップ2と3の費用は最大1,600クレジット($8.00)で、これにステップ1の100クレジット($0.50)が加わります。リンクインバイオのURLがすでに手元にある場合は、Link in Bio APIでそれらのページを1件0.5クレジットでまとめて読み取れます。クリエイターデータのプロバイダーをより広く比較するには、ScrapeCreatorsの代替サービスをご覧ください。
よくある質問(FAQ)
インフルエンサーのメールアドレス検索APIとは何ですか?
クリエイターのソーシャルプロフィールを受け取り、それに関連付けられた公開の連絡用メールアドレスを返すAPIです。SocQのAPIは、各メールアドレスをそれが見つかった公開ページとともに返します。
非公開のメールアドレスや個人のメールアドレスも返しますか?
返すのは、クリエイターがプロフィール文、リンクインバイオのページ、リンクされたWebサイト、ほかのアカウントで公開しているメールアドレスで、その取得元のページも併せて返します。適用されるプライバシーやスパム対策のルールに従って利用してください。
メールアドレスが見つからなかった場合も料金がかかりますか?
はい、0.5クレジットかかります。タスクは成功となり、行は返されません。1件以上のメールアドレスが見つかった場合、照会の料金は8クレジットです。存在しないプロフィールの場合はタスクが失敗し、返金されます。
関連プロフィールの信頼性はどの程度ですか?
各一致には、0〜1のconfidenceと、プロフィール同士が互いにリンクしているといった根拠を示すevidenceが付きます。独自のしきい値を設定し、一致と一緒に根拠も保存してください。
一部のプロフィールで年齢と性別が空になるのはなぜですか?
推定はプロフィール写真に写った顔から行われます。ロゴや集合写真の場合、年齢と性別のフィールドは空になります。