Mídia do Instagram

Representa um álbum, uma foto ou um vídeo (carregado, ao vivo, story ou reel) do Instagram.

Apresentamos o seguinte campo:

• legacy_instagram_media_id

Os seguintes campos do ponto de extremidade da API de Marketing de anúncios do Instagram não são compatíveis:

• filter_name
• location
• location_name
• latitude
• longitude

Criação

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

Leitura

GET /<IG_MEDIA_ID>

Esta operação recupera campos e bordas em mídias do Instagram.

Requisitos

Limitações

• Campos como comments_count e like_count retornam o engajamento apenas da mídia do Instagram e não incluem dados de outras plataformas. Por exemplo, comments_count retorna o número de comentários em uma foto, mas não comentários em anúncios que contêm essa foto. Use total_comments_count e total_like_count para obter contagens agregadas que incluem engajamento de mídia de anúncio, promovida ou turbinada. O número de posts cruzados do Facebook poderá ser incluído se o post estiver acessível pelo usuário da sessão.
• As legendas não incluirão o símbolo @, a menos que o usuário também possa executar tarefas equivalentes às de um administrador no app.
• Alguns campos, como permalink, não podem ser usados em fotos dentro de álbuns (derivados).
• A mídia do Instagram de vídeo ao vivo só pode ser lida durante a transmissão desse conteúdo.
• Essa API retorna apenas dados de mídia de propriedade de contas profissionais do Instagram. Ela não pode ser usada para consultar dados de mídia de propriedade de contas pessoais do Instagram.
• Os campos reposts_count, saved_count, shares_count, total_like_count, total_comments_count e total_views_count não estão disponíveis para mídias subordinadas em um carrossel e são retornados apenas para objetos de mídia de nível superior. O proprietário da mídia pode desabilitar a exibição de curtidas, comentários, visualizações, reposts e compartilhamentos. Nesses casos, os campos correspondentes não serão retornados.

Sintaxe da solicitação

GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
  ?fields=<LIST_OF_FIELDS> \
  &access_token=<ACCESS_TOKEN>

Parâmetros de caminho

Parâmetros da string de consulta

Campos

É possível ler campos públicos por meio da expansão de campos.

Bordas

Bordas públicas podem ser retornadas por meio da expansão de campos.

Exemplo de cURL

Exemplo de solicitação

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

Exemplo de resposta

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

Atualização

POST /<IG_MEDIA_ID>

Habilita ou desabilita comentários em uma mídia do Instagram.

Limitações

Não é compatível com a mídia de vídeo ao vivo do Instagram.

Sintaxe da solicitação

POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

Parâmetros de caminho

Parâmetros da string de consulta

Exemplo de cURL

Exemplo de solicitação

curl -i -X POST \
 "https://graph.instagram.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Exemplo de resposta

{
  "success": true
}

Exclusão

DELETE /<IG_MEDIA_ID>

Exclua mídias do Instagram.

Requisitos

Limitações

Essa API só é compatível com a API do Instagram com o Login do Facebook. Há compatibilidade com posts sem anúncios, stories, reels e álbuns de carrossel inteiros. Para excluir mídias em álbuns de carrossel, o álbum inteiro deve ser excluído. Para isso, especifique a identificação de mídia do contêiner do carrossel. Não é possível excluir mídias individuais em um carrossel.

Sintaxe da solicitação

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?access_token=<ACCESS_TOKEN>

Parâmetros de caminho

Parâmetros da string de consulta

Exemplo de cURL

Exemplo de solicitação

curl -i -X DELETE \
 "https://graph.facebook.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Exemplo de resposta (sucesso)

{
  "success": true,
  "deleted_id": "17918920912340654"
}

Exemplo de resposta (falha, tipo de mídia não compatível)

{
  "error": {
   "message": "Fatal",
   "type": "OAuthException",
   "code": -1,
   "error_subcode": 2207073,
   "is_transient": false,
   "error_user_title": "Media Type Not Supported",
   "error_user_msg": "The media type is not supported for this endpoint",
   "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
  },
}