ユーザーメディア

On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

ユーザーのメディアのコレクションを表します。

作成

この操作はサポートされていません。

読み取り

GET /{user-id}/media

ユーザーのメディアのコレクションを取得します。

制限

ストーリーズはサポートされていません。
宣伝投稿内のメディアはサポートされていません。
最後に作成されたメディアの最大10Kを返します。

要件

型	要件
アクセストークン	Instagramユーザー
アクセス許可	`instagram_graph_user_media`, `instagram_graph_user_profile`

リクエストの構文

GET https://graph.instagram.com/{api-version}/{user-id}/media
  ?access_token={access-token}

パスパラメーター

プレースホルダー	値
`{api-version}` 文字列	APIバージョン。
`{user-id}` 必須文字列	アプリユーザーのapp-scoped user ID (バージョン11.0以降)または生ユーザーID (すべてのバージョン)。

クエリ文字列パラメーター

リクエストに以下のクエリ文字列パラメーターを追加します。

キー	値
`access_token` 必須文字列	アプリユーザーのInstagramユーザーアクセストークン。
`fields` コンマ区切りリスト	結果セット内の各メディアノードのフィールド拡張機能によって戻り値を取得する、メディアフィールドのコンマ区切りリスト。
`since` タイムスタンプ	時間ベースのデータ範囲の始まりを指すUNIXタイムスタンプまたは`strtotime`データ値。時間ベースのページネーションをご覧ください。
`until` タイムスタンプ	時間ベースのデータ範囲の終わりを指すUNIXタイムスタンプまたは`strtotime`データ値。時間ベースのページネーションをご覧ください。

応答

リクエストしたデータを含むJSON形式のオブジェクト。

{
  "data": [],
  "paging": {}
}

応答の内容

プロパティ	値
`data`	ユーザーのメディアの配列。
`paging`	ページングカーソルと次/前のデータセット取得URLを含んでいるオブジェクト。

cURLの例

リクエスト

curl -X GET \
  'https://graph.instagram.com/v21.0/10218560180051171/media?access_token=IGQVJ...'

応答

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

更新

この操作はサポートされていません。

削除

この操作はサポートされていません。