Instagram API

投稿詳細

urlsのリンクから、Instagramの投稿またはリールを1件以上取得します。キャプション、メディアタイプ、いいね数、コメント数、再生数、投稿者のフォロワー数、ハッシュタグ、上位のコメント数件を取得できます。非公開コンテンツは取得されません。写真や動画の権利が付与されるものではありません。

プロフィール

ハンドルまたはプロフィールURLでInstagramアカウントを検索します。表示名、自己紹介、フォロワー数、フォロー数、投稿数、アカウント種別のフラグ、外部リンク、最近の投稿を取得できます。認証済み、ビジネス、プロフェッショナルの各フラグは、本人であることや収入、現在の商業活動を証明するものではありません。

アカウントインサイト

公開プロフィールをもとに、Instagramハンドルのアカウント概要を取得します。自己紹介、カテゴリ、フォロワー数、投稿数、アカウント種別のフラグ、最近の投稿が含まれます。レスポンスには、年齢、性別、興味関心などの属性や購入者情報は含まれず、それらを推測することもありません。

ユーザーの投稿

usernameで指定したInstagramアカウントの投稿を一覧表示します。各投稿にはキャプション、メディアタイプ、いいね数、コメント数、再生数、位置情報、ハッシュタグ、上位コメントが含まれます。全履歴の取得は保証されず、非公開のストーリーズや内部のリーチデータは含まれません。

コンテンツ探索

keywordに指定したInstagramハッシュタグの投稿を追跡します。キャプション、メディアタイプ、エンゲージメント数、投稿者のフォロワー数、位置情報、投稿日時を取得できます。ショート動画を取得するにはresults_typeをreelsに設定します。結果は発見タブのランキングを説明するものではなく、トレンドを証明するものでもありません。

コメント

urlで指定したInstagramの投稿またはリール1件のコメントを取得します。各コメントには本文、投稿者、認証バッジ、いいね数、返信数、投稿日時が含まれます。プロフィールのリンクには対応しておらず、会話ツリー全体の取得は保証されません。

リール

usernameを指定して、Instagramアカウントのリールを取得します。キャプション、再生回数、秒単位の長さ、いいね数、コメント数、ハッシュタグ、音楽、動画リンクが含まれます。字幕の文字起こし、上位コメント、非公開の指標は含まれません。

ハッシュタグ

hashtagに#記号なしで指定したInstagramハッシュタグの投稿を収集します。キャプション、メディアタイプ、いいね数、コメント数、再生数、投稿者、投稿日時を取得できます。ショート動画を取得するにはresults_typeにreelsを指定します。このサンプルだけでトレンドの総量を測ることはできません。

フォロワー

usernameを指定して、Instagramアカウントのフォロワー数とフォロー数を確認します。アカウントのID、表示名、アイコン、プロフィールリンクも取得できます。返されるのは合計数で、フォロワーが誰かは含まれません。アカウントの一覧はfollowers_listで取得できます。

フォロワー一覧

usernameで指定したInstagramユーザーをフォローしているアカウントを一覧表示します。ハンドル、名前、アイコン、非公開・認証フラグ、関係の種類が含まれます。一覧は一部のみの場合があり、自動での連絡に使えるものではありません。

フォロー一覧

usernameで指定したInstagramユーザーがフォローしているアカウントを一覧表示します。ハンドル、名前、アイコン、非公開・認証フラグ、関係の種類が含まれます。フォローしていることは親近感や交流の証明にはならず、関係が変わる可能性もあります。

アカウント検索

keywordでInstagramアカウントを検索します。結果は、その語に対するInstagram検索の順位どおりに並びます。各アカウントには、ハンドル、名前、フォロワー数、フォロー数、投稿数、自己紹介、外部リンク、認証・非公開フラグが含まれます。1回の呼び出しで最大30件、デフォルトは20件です。検索対象はアカウントで、投稿本文は対象外です。

リール検索

keywordにcoffeeなどの語を指定して、Instagramのリールを検索します。各リールには、キャプション、再生回数、いいね数、コメント数、秒単位の長さ、投稿者のハンドルとID、認証バッジ、投稿日時が含まれます。1回の呼び出しで最大200件、デフォルトは20件です。並び順はInstagramの検索に従うため、結果はサンプルであり、その語を使ったすべてのリールではありません。

類似アカウント

nasaなどのusernameで指定したアカウントについて、Instagramが類似アカウントとして提案するアカウントを検索します。各アカウントには、フォロワー数、フォロー数、投稿数、自己紹介、外部リンク、認証・非公開フラグ、フォロワー数順のrankが含まれます。1回の呼び出しで最大30件、デフォルトは20件です。類似として提案されていても、ビジネス上の関係やオーディエンスの共通性を証明するものではありません。

タグ付けされた投稿

username、プロフィールURL、または数値のユーザーIDで指定したInstagramアカウントをタグ付けしている、他のアカウントの公開投稿を一覧表示します。各投稿には、キャプション、いいね数、コメント数、動画かどうか、画像リンク、投稿者のハンドルとID、投稿日時が含まれます。1回の呼び出しで最大200件、デフォルトは20件です。非公開アカウントの投稿は含まれません。

ストーリーズ

ユーザー名を指定して、Instagramアカウントが現在公開中のストーリーズを取得します。各ストーリーズには、メディアリンク、写真か動画かの種別、動画の長さ、投稿日時、投稿者の名前、アイコン、認証状況が含まれます。ストーリーズは24時間で消えるため、公開中のものがないアカウントでは空のリストが返されます。

ストーリーズハイライト

Instagramプロフィールのストーリーズハイライトを一覧表示します。各ハイライトには、ID、タイトル、リンク、カバー画像、含まれるストーリーズの数、作成日時と最終更新日時、アカウントのIDと名前が含まれます。ハイライト内のストーリーズは返されず、media_count、created_at、updated_atが欠けている場合があります。

コメントへの返信

Instagramの投稿またはリールの1件のコメントへの返信を、投稿リンクとcommentsが返すコメントのidから取得します。各返信には本文、いいね数、投稿日時、返信者のユーザー名、ID、アイコン、認証状況が含まれます。1ページあたり最大10件で、件数は変動します。続きはnext_page_tokenで取得してください。