Платформа Instagram

Медиафайлы

Соответствует изображению, видео или альбому.

Создание

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

Чтение

GET /{media-id}

Получение полей и границ контекста изображения, видео или альбома.

Требования

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

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

Пользователь Instagram

Разрешения

instagram_graph_user_media

Синтаксис запроса

GET https://graph.instagram.com/{media-id}
  ?fields={fields}
  &access_token={access-token}

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

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

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

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

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

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

Список полей и границ контекста, которые нужно вернуть (разделенных запятыми). Если его не задать, будут возвращены поля по умолчанию.

Поля

Параметр fields позволяет запросить следующие поля узла Media.

Имя поляОписание

caption

Подпись к изображению или видео. Не возвращается для медиафайлов в альбомах.

id

ID медиафайла.

is_shared_to_feed

Только для видео Reels. Значение true означает, что видео Reels может появиться как на вкладке Лента, так и на вкладке Reels. Значение false означает, что видео Reels может появиться только на вкладке Reels.

Ни одно из этих значений не означает, что видео Reels действительно появится на вкладке Reels, поскольку видео Reels может не соответствовать установленным требованиям или наш алгоритм может его не выбрать. Информацию о критериях соответствия требованиям см. в требованиях к видео Reels.

media_type

Тип медиафайла. Возможные варианты: IMAGE, VIDEO, CAROUSEL_ALBUM.

media_url

URL медиафайла.

permalink

Постоянный URL медиафайла. Если медиафайл содержит материалы, защищенные авторскими правами, или был помечен как нарушающий авторские права, этого поля в ответе не будет.

thumbnail_url

URL миниатюры медиафайла. Только для медиафайлов типа VIDEO.

timestamp

Дата публикации медиафайла в формате ISO 8601.

username

Имя пользователя, опубликовавшего медиафайл.

Границы контекста

С использованием параметра fields или в качестве параметров пути можно запросить следующие границы контекста.

Граница контекстаОписание

children

Список медиафайлов в альбоме. Только для медиафайлов типа CAROUSEL_ALBUM.

Ответ

Объект в формате JSON со стандартными и запрошенными полями и границами контекста.

{
  "{field}":"{value}",
  ...
}

Пример запроса cURL

Запрос

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

Ответ

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

Обновление

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

Удаление

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