API Instagram Basic Display

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

Представляет подборку объектов 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/v19.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..."
  }
}

Обновление

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

Удаление

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