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行で読み取ります。
- /v1/creator/find-social-profiles に {"url": "https://www.instagram.com/miguelangeles"} をPOSTします。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 をマッチ結果と一緒に保存しておくと、後でレコードを確認する人もアカウントを結び付けた理由がわかります。
関連API
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のプロフィール写真から、クリエイターの年齢層と性別を推定し、性別の信頼度スコアを返します。