Instagramアカウントの投稿をAPIで取得する
GET /<IG_ID>/media を使うと、Instagramプロフェッショナルアカウントの投稿を IG Media オブジェクトとして、最新作成順に最大10,000件まで取得できます。id、media_type、media_url、permalink、thumbnail_url、timestamp などのフィールドを指定でき、カルーセルの各項目は children で読み取れます。レスポンスには前後のカーソルが含まれ、since と until で日付範囲を絞り込めます。Instagram Login を使う場合、リクエストは graph.instagram.com に送信します。
easyCoexistence は、接続済みのInstagramアカウントの投稿を list_social_posts で一覧表示します。
メディアエッジが返す最新作成メディアの上限数(Meta の IG User Media リファレンスによる)。
メディアエッジの時間ベースのページングパラメータ。Unix タイムスタンプまたは strtotime の値を受け付けます。
ストーリーズの読み取り方法:メディアエッジはストーリーズを返しません。
thumbnail_url(メディアのサムネイル画像のURL)を返すメディアタイプ。
Meta が media_url の扱いについて示している内容。一部の動画では省略されるため、permalink または thumbnail_url をフォールバックとして使ってください。
アカウントの投稿はどのように取得しますか?
アカウントのメディアエッジに対して GET リクエストを送り、返してほしいフィールドを指定します。fields を省略すると、Meta のサンプルでは各投稿の id だけが返されます。Instagram Login の場合、リクエストは graph.instagram.com に送り、instagram_business_basic 権限を持つ Instagram ユーザーアクセストークンを使います。レスポンスの data に投稿が一覧で入り、次のページ用の paging オブジェクトが付きます。
GET https://graph.instagram.com/<IG_ID>/media
?fields=id,media_type,media_url,permalink,thumbnail_url,timestamp
&limit=25
&access_token=<ACCESS_TOKEN>
{
"data": [
{
"id": "<IG_MEDIA_ID>",
"media_type": "IMAGE",
"media_url": "<CDN_URL>",
"permalink": "https://www.instagram.com/p/<SHORTCODE>/",
"timestamp": "2026-10-30T14:02:11+0000"
}
],
"paging": {
"cursors": { "before": "<CURSOR>", "after": "<CURSOR>" },
"next": "<NEXT_PAGE_URL>"
}
}各投稿はどのフィールドを返せますか?
IG Media オブジェクトのフィールドで、一覧は Meta のリファレンスにあります。使うフィールドだけを指定してください。リファレンスの caption と media_product_type の2行には「Available for Instagram API with Facebook Login only」という注記があるため、利用前に自分の設定で使えるかを確認してください:
ページングはどのように動きますか?
カーソルで行います。paging オブジェクトには before と after のカーソルが含まれ、さらに結果が残っている間は next のURLも含まれます。Meta の Graph API ガイドでは、next が表示されなくなるまで取得を続けるよう案内しています。limit より少ない件数のページもあるためです。メディアエッジは時間でもページングできます。since と until には Unix タイムスタンプまたは strtotime の値を指定し、その範囲の結果だけを返します。
カルーセルの写真や動画はどのように読み取りますか?
children エッジを使います。media_type が CAROUSEL_ALBUM の投稿は、GET /<IG_MEDIA_ID>/children で項目を一覧できます。メディアエッジと同じトークンと権限を使い、各項目は独自の id、media_type、media_url を持つ IG Media オブジェクトです。Meta によると、アルバム内の写真では permalink を含む一部のフィールドは使えません。
GET https://graph.instagram.com/<IG_MEDIA_ID>/children
?fields=id,media_type,media_url
&access_token=<ACCESS_TOKEN>一部の投稿で media_url がないのはなぜですか?
Meta は、著作権で保護されたまたはライセンスを受けた音声を含む動画メディアからは media_url を除外します。Instagram のオーディオライブラリの楽曲も対象で、著作権侵害のフラグが立ったメディアも同様です。アカウント自身の投稿でも起こります。Meta のリファレンスでは media_url を任意項目として扱い、permalink または thumbnail_url にフォールバックするよう案内しています。ライブ動画は配信中にのみ読み取れます。
投稿をウェブサイトに表示するにはどうしますか?
アカウントの長期トークンを使い、サーバー側から取得します。長期トークンの有効期間は60日で、期限が切れる前に更新が必要です。各タイルは permalink にリンクし、一覧は定期的に更新してください。Meta はプライバシーに配慮した CDN のURLでメディアを配信しており、コンテンツが削除または期限切れになると、そのファイルは返されなくなります。Instagram が描画するとおりに投稿を表示したい場合は、代わりに permalink を oEmbed エンドポイントに渡してください。
easyCoexistence で投稿を一覧するにはどうしますか?
list_social_posts を使います。account_id と、1〜100 の limit(既定値は25)を指定すると、アカウントの最近の投稿を、ID、メディアタイプ、メディアURL、サムネイル、permalink、タイムスタンプ、いいね数とコメント数とともに返します。最大 100 件までの最新の投稿を読み取り、次のページや他のフィールドのためのカーソルはありません。
よくある間違い
- メディアエッジでストーリーズを探すこと。Meta はストーリーズを含めません。GET /<IG_ID>/stories で、表示される24時間の間に取得できます。
- media_url だけを頼りにフィードを作ること。Meta は一部の動画で media_url を省略するため、permalink または thumbnail_url をフォールバックとして残してください。
- カルーセルの項目に permalink を要求すること。アルバム内の写真では返されないため、親の投稿にリンクしてください。
- 件数の少ないページを最後だと判断すること。limit より少ない件数のページもあります。next がなくなった時点でのみ停止してください。
1回に1〜100件で、Claude、ChatGPT、または自社のコードから、トークンを付けてMetaの公式APIを通じて呼び出せます。料金は接続1件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の3日間は無料です。
よくある質問
Instagram APIは投稿を何件まで返せますか?
最新作成順に最大10,000件まで、メディアエッジからページ単位で返せます。ストーリーズは、表示期間中に別のストーリーズエッジから取得します。
メディアエッジにはリールも含まれますか?
はい。リールは写真と同じ IG Media オブジェクトで、media_type は VIDEO として返されます。メディアエッジから除外されるのはストーリーズです。
他のアカウントの投稿を取得できますか?
メディアエッジでは取得できません。メディアエッジはトークンに紐づくアカウントを読み取ります。他のビジネスアカウントやクリエイターアカウントの投稿は、Facebook Login または Unified Login を使う Business Discovery で取得できます。
古い media_url が使えなくなったのはなぜですか?
Meta の CDN のURLはプライバシーに配慮した仕組みで、コンテンツが削除または期限切れになると、メディアを返さなくなります。必要なときは最新のURLを取得し直してください。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日