Plataforma do Instagram
Voltar para Português (Brasil)
Este documento foi atualizado.
A tradução para Português (Brasil) não foi concluída ainda.
Atualização em inglês: 4 de set

Mídia do Instagram

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

Desde 3 de junho de 2024, é possível usar o campo boost_eligibility_info para verificar de forma conveniente e eficiente se a mídia pode ser turbinada como anúncio e boost_ads_list para acompanhar informações anteriores de anúncios turbinados. Consulte nosso blog para saber mais. Disponível apenas para a Graph API do Instagram.

Criação

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

Leitura

GET /<IG_MEDIA_ID>

Essa operação obtém campos e bordas em mídias do Instagram.

Limitações

  • Os campos que retornam valores agregados não incluem dados gerados por anúncios. Por exemplo, comments_count conta os comentários em uma foto, mas não os comentários em anúncios que contêm a foto.
  • As legendas não incluem 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 obter dados de mídia de propriedade de contas pessoais do Instagram.

Sintaxe da solicitação

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Parâmetros de caminho

Espaço reservadoValor

<API_VERSION>

A versão da API.

<IG_MEDIA_ID>

Obrigatório. A identificação da mídia que será publicada.

Parâmetros da string de consulta

ChaveEspaço reservadoValor

access_token

<ACCESS_TOKEN>

Obrigatório. O token de acesso do usuário do app.

fields

<LIST_OF_FIELDS>

Uma lista separada por vírgulas de campos que devem ser retornados.

Campos

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

CampoDescrição

boost_ads_list

Oferece uma visão geral de todas as informações de anúncios do Instagram associadas à mídia orgânica. Inclui a identificação relativa e o status de veiculação do anúncio. Disponível apenas para a Graph API do Instagram.

boost_eligibility_info

O campo fornece informações sobre como promover a qualificação de uma mídia do Instagram como um anúncio e detalhes adicionais se ela não for qualificada. Disponível apenas para a Graph API do Instagram.

caption
Público

Legenda. Exclui derivados de álbum. O símbolo @ será excluído, a menos que o usuário do app possa realizar tarefas equivalentes às de administrador na Página do Facebook conectada à conta do Instagram usada para criar a legenda (apenas para a Graph API do Instagram).

comments_count
Público

Contagem de comentários na mídia. Exclui comentários na mídia derivada do álbum e na legenda da mídia. Inclui respostas em comentários.

copyright_check_information.status

Retorna os objetos status e matches_found.

Objetos de statusDescrição

status

  • completed: o processo de detecção foi concluído.
  • error: ocorreu um erro durante o processo de detecção.
  • in_progress: o processo de detecção está em andamento.
  • not_started: o processo de detecção não foi iniciado.

matches_found

Defina como um dos valores a seguir:

  • false se o vídeo não violar direitos autorais.
  • true se o vídeo violar direitos autorais.

Caso o vídeo esteja violando direitos autoriais, copyright_matches será retornado com uma matriz de objetos sobre o material protegido por direitos autorais (quando a violação ocorrer no vídeo) e as ações tomadas para mitigar a violação.

Objetos de copyright_matchesDescrição

author

O autor do vídeo protegido por direitos autorais.

content_title

O nome do vídeo protegido por direitos autorais.

matched_segments

Uma matriz de objetos com os seguintes pares de chave-valor*: duration_in_seconds (o número de segundos que o conteúdo viola direitos autorais)*. segment_type: AUDIO ou VIDEO*. start_time_in_seconds (definido como a hora de início do vídeo).

owner_copyright_policy

Objetos retornados:

  • name: o nome da política do proprietário dos direitos autorais.

  • actions: uma matriz de objetos action com as etapas de mitigação definidas pela política do proprietário dos direitos autorais. Pode incluir diferentes etapas de mitigação dependendo da localização.

    • action: a ação de mitigação tomada em relação ao vídeo que viola os direitos autorais. Medidas de mitigação distintas podem ser tomadas para diferentes países. Pode ser um dos seguintes valores:
      • BLOCK: o vídeo está bloqueado para os públicos listados na matriz geos.
      • MUTE: o vídeo está silenciado para os públicos listados na matriz geos.

id
Público

O ID da mídia.

is_comment_enabled

Indica se os comentários estão habilitados ou desabilitados. Exclui derivados de álbum.

is_shared_to_feed
Público

Somente no 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.

like_count

Contagem de curtidas na mídia, incluindo respostas a comentários. Exclui curtidas na mídia derivada do álbum e em publicações promovidas que foram criadas a partir da mídia.


Se for consultado indiretamente através de outro ponto de extremidade ou da expansão de campo, o campo like_count será omitido caso o proprietário da mídia tenha ocultado a contagem de curtidas.

media_product_type
Público

Plataforma em que a mídia é publicada. Pode ser AD, FEED, STORY ou REELS. Disponível apenas para a Graph API do Instagram.

media_type
Público

Tipo de mídia. Pode ser CAROUSEL_ALBUM, IMAGE ou VIDEO.

media_url
Público

A URL da mídia.

O campo media_url será omitido das respostas caso a mídia contenha material protegido por direitos autorais ou tenha sido sinalizada como uma violação desses direitos. Exemplos de materiais protegidos por direitos autorais incluem áudios em reels.

owner
Público

Número de identificação do usuário do Instagram que criou a mídia. Retornado somente se o usuário do app que está fazendo a consulta também tiver criado a mídia. Caso contrário, o campo username é retornado.

permalink
Público

URL permanente da mídia.

shortcode
Público

Código curto da mídia.

thumbnail_url
Público

URL de miniatura da mídia. Disponível apenas em mídias de VIDEO.

timestamp
Público

Data de criação de acordo com a norma ISO 8601 no formato UTC. O padrão é UTC ±00:00.

username
Público

Nome de usuário da pessoa que criou a mídia.

Bordas

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

BordaDescrição

children
Pública.

Representa uma coleção de objetos de mídia em um álbum de mídias do Instagram.

collaborators

Representa uma lista de usuários adicionados como colaboradores em um objeto de mídia do Instagram. Disponível apenas para a Graph API do Instagram.

comments

Representa uma coleção de comentários em um objeto de mídia do Instagram.

insights

Representa as métricas de interação social em um objeto de mídia do Instagram. Disponível apenas para a Graph API do Instagram.

Exemplo de cURL

Exemplo de solicitação

curl -X GET \
  'https://graph.instagram.com/v21.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

A mídia do Instagram de vídeo ao vivo não é compatível.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_manage_comments
  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • business_management

Sintaxe da solicitação

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

Parâmetros de caminho

Espaço reservadoValor

<API_VERSION>

A versão da API.

<IG_MEDIA_ID>

Obrigatório. O ID da mídia do Instagram.

Parâmetros da string de consulta

ChaveEspaço reservadoValor

access_token

<ACCESS_TOKEN>

Obrigatório. O token de acesso do usuário do app.

comment_enabled

<BOOL>

Obrigatório. Defina como true para habilitar ou false para desabilitar comentários.

Exemplo de cURL

Exemplo de solicitação

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

Exemplo de resposta

{
  "success": true
}

Exclusão

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