Платформа Instagram

Медиафайлы

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 /{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

Подпись к изображению или видео. Не возвращается для медиафайлов в альбомах. Примечание. При использовании смайликов в подписях форматом кодировки должен быть UTF-8, а количество символов может быть разным в зависимости от используемого смайлика.

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

Обновление

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

Удаление

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