creator/
find-social-profiles

Instagram、TikTok、YouTube、X、FacebookのプロフィールURL1件を起点に、同じクリエイターがほかのSNSで運営しているアカウントを、信頼度スコアとひも付けの根拠とともに返します。

Social Media Profile Finder API

プロフィールURL1件
SNS横断のマッチング
0〜1の信頼度
マッチごとの根拠
1リクエストあたり8クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Social Media Profile Finder

多くのクリエイターは複数のSNSで発信しており、それらのアカウントをつなぐ手がかりはプロフィール欄、個人サイト、リンクインバイオのページに散らばっていて、SNSごとにハンドルが違うこともあります。この検索はすでに知っている1つのプロフィールから、そのクリエイターのほかのSNSのアカウントを返し、それぞれに0から1のスコアと、互いのプロフィールへのリンクや共通のWebサイトなど同一人物と判断した手がかりを添えます。

Social Media Profile Finder API の主な機能

  • ひも付いたアカウントごとに1行各行がほかのSNSのアカウント1件を表し、network、username、url を含むため、TikTok、YouTube、Xのアカウントが別々のレコードとして返ります。
  • 信頼度スコアconfidence は、そのアカウントが同じクリエイターのものである可能性を0から1で示し、自動マッチングのしきい値を自由に決められます。
  • マッチごとの根拠evidence には reciprocal_profile_link、same_handle、website_link など、アカウントを結び付けた手がかりが並び、どのマッチも理由を説明できます。
  • すべての行に起点プロフィールsource_network と source_url に検索したプロフィールが入るため、結果を自社のクリエイターリストに簡単に結合できます。

Social Media Profile Finder API のパラメータ

パラメータ必須説明
url必須SNS横断でマッチングしたいクリエイターのInstagram、TikTok、YouTube、X、FacebookのプロフィールURLを1件。

Social Media Profile Finder API の使い方

クリエイターのプロフィールURLを1件送り、ほかのSNSで見つかったアカウントを1件1行で読み取ります。

  1. /v1/creator/find-social-profiles に {"url": "https://www.instagram.com/miguelangeles"} をPOSTします。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items からひも付いたアカウントを1行ずつ読み取り、has_more が true の間は results.next_cursor を渡します。
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"}'

Social Media Profile Finder API の主なユースケース

  • SNS横断のクリエイタープロフィール作成: クリエイターを見つけたSNSを起点に、TikTok、YouTube、X、Facebookのアカウントを1つのクリエイターレコードに追加します。
  • クリエイターDBの重複統合: 信頼度の高いマッチを使い、別々のSNSから登録されたレコードが同一人物であると判断して1件にまとめます。
  • 全チャンネルでのキャンペーン計測: 提携クリエイターごとにほかのアカウントを洗い出し、契約したSNSだけでなく投稿しているすべての場所で投稿とリーチを集計します。

Social Media Profile Finder API 活用のヒント

  • 自動統合用の信頼度しきい値を決め、それより低いスコアは evidence と一緒に目視確認へ回してください。
  • ひも付いたアカウントのプロフィールURLである id をキーにすると、同じクリエイターの別プロフィールから検索した結果もそろいます。
  • evidence をマッチ結果と一緒に保存しておくと、後でレコードを確認する人もアカウントを結び付けた理由がわかります。

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

  • Influencer Email Finder API — Instagram、TikTok、YouTube、X、Facebookのプロフィール1件から、クリエイターが公開しているビジネスメールを、見つかったページとともに探します。
  • Age and Gender Detection API — Instagram、TikTok、YouTube、X、Threadsのプロフィール写真から、クリエイターの年齢層と性別を推定し、性別の信頼度スコアを返します。

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

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

Social Media Profile Finder API — よくある質問

Social Media Profile Finder APIは、プロフィールURL1件からクリエイターがほかのSNSで運営しているアカウントを探すためのプログラム用インターフェースです。各マッチには信頼度スコアとひも付けの根拠が付きます。

1回のリクエストでInstagram、TikTok、YouTube、X、FacebookのプロフィールURLを1件送ります。結果には、そのクリエイターのほかのSNSのアカウントが入ります。

confidence は0から1の値で、そのアカウントが同じクリエイターのものである可能性を示します。evidence は、互いのプロフィールへのリンク、同じハンドル、共通のWebサイトなど、マッチの根拠となった手がかりです。

結果にはクリエイターのほかのアカウントが並び、送ったプロフィールはすべての行の source_network と source_url に入ります。

1回の検索は8クレジットで、ほかのSNSで見つかったアカウントごとに1行が返ります。プロフィールが存在しない場合はタスクが失敗し、全額返金されます。