Creator データAPI
Instagram、TikTok、YouTube、X、Facebook、Threadsのプロフィール1件を起点に、クリエイターの公開ビジネスメール、ほかのSNSのアカウント、プロフィール写真からの年齢・性別の推定を取得します。
利用できるCreator API
公開されている連絡先メールにはInfluencer Email Finder APIを、ほかのSNSのアカウントにはSocial Media Profile Finder APIを、プロフィール写真からの推定にはAge and Gender Detection APIを使用します。
取得できるクリエイターデータ
どのCreator APIもプロフィールURLを1件受け取り、送信したプロフィールにひも付いた正規化済みの行を返します。
公開ビジネスメール
プロフィール欄、リンクインバイオのページ、リンク先のWebサイト、ほかのSNSアカウントに公開されている連絡先メールを、見つかったページとともに探します。
ほかのSNSのアカウント
クリエイターのほかのSNSのアカウントを、ネットワーク、ユーザー名、URL、0〜1の信頼度、マッチごとの根拠とともに一覧にします。
年齢層と性別
プロフィール写真の顔から年齢の範囲と性別を推定し、0〜100の信頼度を付けます。
起点プロフィールの情報
検索したネットワーク、ハンドル、プロフィールURLをすべての行に保持し、自社のクリエイターリストと結合しやすくします。
SocQと手作業でのクリエイター調査の比較
SocQはプロフィールURLを1回のリクエストで構造化された行に変えます。手作業の調査では、プロフィール欄、リンクページ、Webサイト、ほかのSNSを1つずつ開き、見つけた情報を手で記録する必要があります。
| 機能 | SocQ | 手作業での調査 |
|---|---|---|
| 入力の起点 | リクエストごとにプロフィールURL1件 | 各SNSやページを手で検索 |
| メールの探索範囲 | プロフィール欄、リンクインバイオのページ、リンク先のWebサイト、ほかのアカウント(メールごとに出典ページつき) | ページを1つずつ確認 |
| SNS横断のマッチング | すべてのマッチに信頼度スコアと根拠 | アカウントごとの個人判断 |
| 成果物 | データベースにそのまま入る正規化済みの行 | 手作業で管理するメモや表 |
Creator APIの仕組み
すべてのCreator APIが、SocQ共通の非同期タスクと保存済み結果の取得ワークフローを使用します。
1. エンドポイントを選ぶ
プロフィールURLを1件 url に入れて /v1/creator/find-emails、/v1/creator/find-social-profiles、/v1/creator/age-gender のいずれかにPOSTし、task_id を保存します。
2. タスクを追跡
タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
3. 行を読み取る
data.results.items を読み取り、has_more が true の間は next_cursor をたどります。
SocQのAPIキーで認証し、プロフィールURLを1件送信します。メールが見つかった検索は8クレジット、見つからなかった検索は0.5クレジットです。
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"}'
# Poll GET /v1/tasks/{task_id}
# Read the emails and their source_urls in data.results.itemsCreator APIの主なユースケース
インフルエンサーへのアプローチ
キャンペーン候補リストの各クリエイターに、公開ビジネスメールとその出典を追加します。
SNS横断のクリエイターレコード
クリエイターのTikTok、YouTube、X、Facebookのアカウントを1つのレコードにまとめ、SNSをまたいだ重複を統合します。
属性によるスクリーニング
コンテンツを確認する前に、推定年齢層と性別でクリエイターリストを絞り込みます。
制限事項と公開データポリシー
Creator APIは公開プロフィールと公開ページをもとに動作し、1回のリクエストでプロフィールURLを1件受け付けます。
- Influencer Email FinderとSocial Media Profile FinderはInstagram、TikTok、YouTube、X、Facebookのプロフィールを受け付けます。メール検索ではYouTubeチャンネルを @handle かチャンネルIDでも指定できます。
- Age and Gender DetectionはInstagram、TikTok、YouTube、X、Threadsのプロフィールを受け付け、はっきりした顔写真の個人アカウントに向いています。
- Influencer Email Finderはクリエイターが公開しているメールを、それぞれの掲載ページとともに返します。
- 存在しないプロフィールを送った場合はタスクが失敗し、全額返金されます。
Creator APIに関するよくある質問
Creator APIとは何ですか?
SNSのプロフィールURL1件から、クリエイターの公開ビジネスメール、ほかのSNSのアカウント、プロフィール写真からの年齢・性別の推定を返す3つの検索APIです。
どのSNSを起点にできますか?
メール検索とアカウント検索はInstagram、TikTok、YouTube、X、Facebook、年齢・性別推定はInstagram、TikTok、YouTube、X、Threadsが起点になります。
Creator APIの料金はどのように計算されますか?
Influencer Email Finderはメールが見つかれば8クレジット、見つからなければ0.5クレジット、Social Media Profile Finderは1回8クレジット、Age and Gender Detectionは1回1クレジットです。
メールはどこから見つけていますか?
プロフィール欄、リンクインバイオのページ、リンク先のWebサイト、クリエイターのほかのアカウントから探し、すべてのメールに見つかった公開ページが付きます。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
Google Hotels API
目的地でホテルを検索し、任意のホテルのGoogleホテル上のプロフィールと1泊料金カレンダーを取得します。3つはすべて同じホテルIDでつながります。
Brand Monitoring API
ブランド、製品、トピックに言及したWebページを探し、ページごとに感情をスコア化し、Web全体での語られ方を要約します。
AI Search API
AI概要、ChatGPT、GoogleのAIモードが市場の質問にどう答えているかを追跡します。ブランドに触れた回答、可視性の高さ、引用されているドメインとページがわかります。
Instagram API
公開プロフィールを検索・照会し、フォロワーリストのレコード、フォロー関係、投稿、プロフィールがタグ付けされた投稿、ハッシュタグの検索結果、リール、文字起こし、コメント、アカウント数値、エンゲージメント指標、メディアのメタデータを、1つの非同期ワークフローで取得できます。
TikTok API
対応する公開TikTokプロフィール、個別動画のメタデータ、トップレベルコメント、動画の検索結果、指定したハッシュタグの動画を、正規化された1つの非同期ワークフローで取得できます。
YouTube API
対応する公開YouTubeのチャンネルプロフィール、動画の詳細、チャンネルの動画、コメント、ショート、キーワード・ハッシュタグの検索結果、取得可能な文字起こしを、正規化された1つの非同期ワークフローで取得できます。


