Mídia de usuário

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 coleção de mídia em um usuário.

Criação

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

Leitura

GET /{user-id}/media

Obtenha uma coleção de mídia em um usuário.

Limitações

Não há suporte para stories.
Não há suporte para mídias em publicações promovidas.
Retorna o máximo de 10.000 dos objetos de mídia mais recentes.

Requisitos

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

Sintaxe da solicitação

GET https://graph.instagram.com/{api-version}/{user-id}/media
  ?access_token={access-token}

Parâmetros de caminho

Espaço reservado	Valor
`{api-version}` String	A versão da API.
`{user-id}` Obrigatório String	Os IDs do usuário no escopo do app (para a versão 11.0 ou superiores) ou o número de identificação bruto do usuário (em todas as versões).

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 de mídia que você quer recuperar pela expansão de campo de cada nó de mídia no conjunto de resultados.
`since` Registro de data e hora	Um registro de data e hora do Unix ou um valor de dados `strtotime` que aponta para o início do intervalo de dados baseados em tempo. Veja mais sobre paginação baseada em tempo.
`until` Registro de data e hora	Um registro de data e hora do Unix ou um valor de dados `strtotime` que aponta para o final do intervalo de dados baseados em tempo. Veja mais sobre paginação baseada em tempo.

Resposta

Um objeto formatado por JSON contendo os dados solicitados.

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

Conteúdos de resposta

Propriedade	Valor
`data`	Uma matriz de mídia no usuário.
`paging`	Um objeto com cursores de paginação e URLs de recuperação para o conjunto de dados seguinte/anterior.

Exemplo de cURL

Solicitação

curl -X GET \
  'https://graph.instagram.com/v21.0/10218560180051171/media?access_token=IGQVJ...'

Resposta

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Atualização

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

Exclusão

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