API一覧に戻る
クリエイターインテリジェンス

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. 1. エンドポイントを選ぶ

    プロフィールURLを1件 url に入れて /v1/creator/find-emails、/v1/creator/find-social-profiles、/v1/creator/age-gender のいずれかにPOSTし、task_id を保存します。

  2. 2. タスクを追跡

    タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。

  3. 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.items

Creator 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つの非同期ワークフローで取得できます。