instagram/
post-likers

公開Instagram投稿のURLから、いいねしたユーザーのリストに含まれるアカウントを収集し、各ユーザーのユーザー名、表示名、アバター、認証バッジと非公開アカウントの状態を返します。

Instagram Post Likers API

投稿URLを入力
いいねしたユーザー一覧
最大1,000アカウント
結果1件あたり0.3クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Post Likers

いいねしたユーザーのリストは、投稿のいいね数をタップしたときにInstagramが表示するアカウントの一覧で、写真、リール、動画に誰が反応したのかを直接確認できます。これらのアカウントを分析すると、投稿が実際にどんなオーディエンスに届いたか、どんな注目プロフィールが反応したか、投稿やキャンペーンごとに顔ぶれがどう違うかがわかります。

Instagram Post Likers API の主な機能

  • 投稿リンクからいいねしたユーザーを取得投稿、リール、IGTVのURLを貼り付けるだけで、Instagramがいいねとして表示しているアカウントを取得できます。
  • 全ユーザーの基本プロフィール各ユーザーには、ユーザーID、ユーザー名、表示名、プロフィールリンク、アバター、認証バッジと非公開アカウントのフラグが related_actor 内に含まれます。
  • いいねとしてラベル付けされたレコードすべてのレコードに relationship = liker が付くため、追加のマッピングなしで、フォロワーやフォロー中のデータと同じパイプラインに並べて扱えます。

Instagram Post Likers API のパラメータ

パラメータ必須説明
url必須公開されている投稿、リール、IGTV動画へのリンクです。
results_limit任意返すいいねしたユーザーの数で、1〜1000の範囲で指定します。デフォルトは100です。

Instagram Post Likers API の使い方

投稿リンクを貼り付けてタスクを実行し、結果からいいねしたユーザーを読み取ります。

  1. 公開されている投稿、リール、IGTV動画のURLをコピーします。
  2. url と任意の results_limit を /v1/instagram/post-likers に POST します。
  3. GET /v1/tasks/{task_id} の status が succeeded になるまで待ちます。
  4. results.items からいいねしたユーザーを読み取り、results.has_more が true の間は results.next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/instagram/post-likers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/p/DRhvwVLAHAG/","results_limit":100}'

# Each result is one liker, with the account details in related_actor.
# Read them from GET /v1/tasks/{task_id}.

Instagram Post Likers API の主なユースケース

  • キャンペーンのオーディエンス確認: タイアップ投稿にいいねしたユーザーを取得し、実際にどのようなアカウントに届いたのかを把握します。
  • リピートファンの発見: 複数の投稿にいいねしたユーザーを集め、ユーザーIDを突き合わせて、何度もいいねしてくれる人を見つけます。
  • 注目アカウントの抽出: is_verified でいいねしたユーザーを絞り込み、投稿にいいねしたクリエイター、ブランド、著名人を洗い出します。

Instagram Post Likers API 活用のヒント

  • 複数の投稿にまたがるユーザーの突き合わせには related_actor.id を使ってください。ユーザー名が変更されても変わりません。
  • 投稿の合計いいね数はInstagram Post Infoから取得し、いいねしたユーザーのリストはInstagramが表示対象に選んだアカウントとして扱ってください。
  • フォロワー数やプロフィール文もあわせて取得したい場合は、いいねしたユーザーのユーザー名をInstagram Profilesに送信してください。

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

  • Instagram Followers Count API — 公開プロフィールのアカウント情報と、表示中のフォロワー数・フォロー数・投稿数を取得します。
  • Instagram Comments API — 投稿URLから、公開コメント、投稿者、タイムスタンプ、いいね、返信を取得します。
  • Instagram Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、リンク、アカウント属性、カテゴリ、表示中のカウントを取得します。
  • Instagram Followers List API — 公開フォロワーのプロフィールレコードを、元のアカウントと関係性の情報とともに取得します。
  • Instagram Following List API — Instagramアカウントがフォローしている公開プロフィールを、アカウント情報、関係性の情報、表示中のアカウントのカウントとともに取得します。
  • Instagram Post Info API — 既知の公開投稿、リール、旧IGTVのURLを検索し、キャプション、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメント、入力情報を返します。

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

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

Instagram Post Likers API — よくある質問

Instagram Post Likers APIは、公開Instagram投稿、リール、IGTV動画のURLを入力として、いいねしたユーザーのリストからアカウントを収集するAPIです。各ユーザーのユーザーID、ユーザー名、表示名、プロフィールリンク、アバター、認証バッジと非公開アカウントのフラグを返します。

はい。投稿URLを送信すると、いいねしたユーザーのリストに含まれるアカウントが、ユーザー名、表示名、アバターとあわせて返されます。

はい。公開されている投稿、リール、IGTVのリンクであれば利用でき、/p/ や /reel/ の前にアカウント名が入ったリンクにも対応しています。

related_actor.username に入っており、レコードの url フィールドはそのユーザーのプロフィールに直接リンクしています。

返されたいいねしたユーザー1件につき0.3クレジットです。