Instagram Basic Display API

Медиафайлы пользователя

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.

Представляет подборку объектов Media пользователя User.

Создание

Эта операция не поддерживается.

Чтение

GET /{user-id}/media

Получение подборки объектов Media пользователя User.

Ограничения

  • Истории не поддерживаются.
  • Медиафайлы в продвигаемых публикациях не поддерживаются.
  • Возвращает до 10 000 самых новых медиафайлов.

Требования

ТипТребование

Маркеры доступа

Пользователь 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}
Обязательный
Строка

ID пользователя внутри приложения (для версии 11.0 и более поздних) или обычный ID пользователя (для всех версий).

Параметры строки запроса

В строку запроса можно включить следующие параметры:

КлючЗначение

access_token
Обязательный
Строка

Маркер доступа пользователя Instagram для пользователя приложения.

fields
Список значений через запятую

Разделенный запятыми список полей Media, которые должно возвращать расширение поля для каждого узла Media в наборе результатов.

since
Метка времени

Метка времени в формате Unix или значение данных strtotime, указывающее на начало диапазона данных, выбираемых по времени. См. раздел Разбивка на страницы по времени.

until
Метка времени

Метка времени в формате Unix или значение данных strtotime, указывающее на конец диапазона данных, выбираемых по времени. См. раздел Разбивка на страницы по времени.

Ответ

Объект в формате JSON, содержащий запрошенные данные.

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

Содержимое ответа

СвойствоЗначение

data

Массив объектов Media пользователя User.

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..."
  }
}

Обновление

Эта операция не поддерживается.

Удаление

Эта операция не поддерживается.