instagram/
similar-users

公開プロフィールのユーザー名から、Instagramが関連して推奨するアカウントを取得し、各アカウントのユーザー名、表示名、アバター、認証バッジの状態を返します。

Instagram Similar Accounts API

ユーザー名を入力
推奨アカウント
認証バッジの状態
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Similar Accounts

類似アカウントは、あるアカウントの隣にInstagramが推奨するプロフィールで、それぞれユーザー名、表示名、アバター、認証バッジの状態が表示されます。まとめて見ると、Instagramがブランドやクリエイターの同類と見なしているアカウントがわかり、ニッチな領域とその中の競合を手早く把握できます。

Instagram Similar Accounts API の主な機能

  • 1つのユーザー名から推奨アカウントを取得公開アカウントのユーザー名を1つ指定すると、Instagramが関連して推奨するアカウントが返され、起点のアカウントは extra.source_username に記録されます。
  • 各アカウントの素性がわかるすべての推奨アカウントに、ユーザーID、ユーザー名、表示名、プロフィールリンク、アバターに加え、認証バッジと非公開アカウントのフラグが含まれます。
  • 取得件数を指定results_limit を1〜100の範囲で設定できます。指定しない場合は最大50件の推奨アカウントが返されます。

Instagram Similar Accounts API のパラメータ

パラメータ必須説明
username必須推奨アカウントを取得したいアカウントのユーザー名です。先頭の @ は省略できます。
results_limit任意返す推奨アカウントの数で、1〜100の範囲で指定します。デフォルトは50です。

Instagram Similar Accounts API の使い方

起点となるアカウントを選んでユーザー名を送信し、タスクの完了後に推奨アカウントを読み取ります。

  1. 起点となるアカウントを選びます。よく知っているブランドやクリエイターなどが適しています。
  2. {"username": "instagram", "results_limit": 50} を /v1/instagram/similar-users に POST します。
  3. status が succeeded になるまで GET /v1/tasks/{task_id} を確認し、results.items を読み取ります。
  4. 件数が多い場合は、results.has_more が true の間 results.next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/instagram/similar-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"instagram","results_limit":50}'

# Keep the task_id from the response,
# then read the suggested accounts from GET /v1/tasks/{task_id}.

Instagram Similar Accounts API の主なユースケース

  • 競合のマッピング: 自社ブランドのアカウントを起点にして、Instagramが自社の隣に並べるプロフィールを一覧にします。
  • インフルエンサーの発掘: すでに成果の出ているクリエイターを起点に検索し、類似アカウントを次のキャンペーンの候補として検討します。
  • ニッチ領域の調査: 同じカテゴリの複数のアカウントで推奨アカウントを取得し、何度も登場するユーザー名を数えて、そのニッチの中心にいるプロフィールを見つけます。

Instagram Similar Accounts API 活用のヒント

  • 候補を絞り込む前に、推奨されたユーザー名をInstagram Profilesに送信して、フォロワー数、プロフィール文、投稿数を補完してください。
  • 次のステップで投稿やストーリーズを収集する場合は、is_private が true のアカウントを除外しておいてください。
  • 複数回の実行結果を統合するときは extra.source_username を残しておくと、どの起点から出た推奨アカウントかを区別できます。

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

  • Instagram Followers Count API — 公開プロフィールのアカウント情報と、表示中のフォロワー数・フォロー数・投稿数を取得します。
  • Instagram Posts API — ユーザー名から、公開投稿、メディア、ハッシュタグ、メンション、タイムスタンプ、エンゲージメントを取得します。
  • Instagram Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、リンク、アカウント属性、カテゴリ、表示中のカウントを取得します。
  • Instagram Followers List API — 公開フォロワーのプロフィールレコードを、元のアカウントと関係性の情報とともに取得します。
  • Instagram Following List API — Instagramアカウントがフォローしている公開プロフィールを、アカウント情報、関係性の情報、表示中のアカウントのカウントとともに取得します。
  • Instagram Stories API — ユーザー名から、公開アカウントが現在公開中のストーリーズを収集し、ストーリーのメディア、投稿時刻、有効期限を返します。

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

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

Instagram Similar Accounts API — よくある質問

Instagram Similar Accounts APIは、公開アカウントのユーザー名を入力として、Instagramが関連して推奨するアカウントを取得するAPIです。各アカウントのユーザーID、ユーザー名、表示名、プロフィールリンク、アバター、認証バッジと非公開アカウントのフラグを返します。

競合のユーザー名を送信すると、そのプロフィールの隣にInstagramが推奨するアカウントが返されます。

results_limit で指定でき、最大100件です。デフォルトは50件です。

推奨されたユーザー名をInstagram Profiles APIに送信すると、各アカウントのフォロワー数、フォロー数、投稿数が返されます。

返された推奨アカウント1件につき0.5クレジットです。そのため results_limit は、1回のリクエストにかかる最大額の上限にもなります。