Mídia

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.

Representa uma imagem, um vídeo ou um álbum.

Criação

Esta operação não é compatível.

Leitura

GET /{media-id}

Obtenha campos e bordas de uma imagem, um vídeo ou um álbum.

Requisitos

Tipo	Requisito
Tokens de acesso	Usuário do Instagram
Permissões	`instagram_graph_user_media`

Sintaxe da solicitação

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

Parâmetros da string de consulta

Inclua o parâmetro da string de consulta a seguir para ampliar a solicitação.

Chave	Valor
`access_token` Obrigatório String	O token de acesso do usuário do Instagram do usuário do app.
`fields` Lista separada por vírgulas	Uma lista separada por vírgulas dos campos e bordas que devem ser retornados. Se omitida, os campos-padrão serão retornados.

Campos

Use o parâmetro de string de consulta fields para solicitar os seguintes campos em uma mídia.

Nome do campo	Descrição
`caption`	O texto na legenda da mídia. Não retornável para mídias em álbuns. Observação: ao usar emojis nas legendas, o formato de codificação deve ser UTF-8, e o número de caracteres pode ser afetado dependendo do emoji usado.
`id`	O ID da mídia.
`is_shared_to_feed`	Somente para Reels. `true` indica que o reel pode aparecer nas abas Feed e Reels. `false` indica que o reel pode aparecer apenas na aba Reels. Nenhum desses valores garante que o reel aparecerá na aba Reels, porque ele pode não cumprir os requisitos de qualificação ou não ser selecionado pelo algoritmo. Consulte os critérios de qualificação nas especificações de reel.
`media_type`	O tipo de mídia. Pode ser `IMAGE`, `VIDEO` ou `CAROUSEL_ALBUM`.
`media_url`	A URL da mídia.
`permalink`	A URL permanente da mídia. Será omitida se a mídia contiver material protegido por direitos autorais ou tiver sido sinalizada como violação desses direitos.
`thumbnail_url`	A URL da imagem em miniatura da mídia. Disponível somente em mídias de `VIDEO`.
`timestamp`	A data de publicação da mídia no formato ISO 8601.
`username`	O nome de usuário do proprietário da mídia.

Bordas

Você pode solicitar as bordas a seguir como parâmetros de caminho ou usar o parâmetro de string de consulta fields.

Borda	Descrição
`children`	Obtenha a lista de mídias do álbum. Disponível somente em mídias de `CAROUSEL_ALBUM`.

Resposta

Um objeto formatado por JSON contendo os campos e as bordas solicitadas e padrão.

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

Exemplo de cURL

Solicitação

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

Resposta

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

Atualização

Esta operação não é compatível.

Exclusão

Esta operação não é compatível.