Plataforma do Instagram

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.

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).
  • Para que possam ser acessadas via API, as mídias do Instagram TV precisam ser compartilhadas no Instagram no momento da publicação (opção Publicar uma prévia ou Compartilhar prévia no feed habilitada).
  • A mídia do Instagram de vídeo ao vivo só pode ser lida durante a transmissão desse conteúdo.

Requisitos

TipoDescrição

Tokens de acesso

Usuário.

Permissões

instagram_basic
pages_read_engagement
pages_show_list


Caso uma função na Página tenha sido concedida ao usuário do app por meio do Gerenciador de Negócios, você também precisará obter uma das seguintes:


ads_management
business_management

Sintaxe da solicitação

GET https://graph.facebook.com/{api-version}/{ig-media-id}
  ?fields={fields}
  &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.

fields

{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

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.

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.

ig_id
Público

O ID da mídia do Instagram. Usado com a API do Instagram antiga, agora obsoleta. Em vez disso, use id.

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.


Caso a consulta seja feita de forma indireta por meio de outro ponto de extremidade ou da expansão de campo:


  • Chamadas da versão 10.0 e anteriores: o valor é 0 caso o dono da mídia tenha ocultado o número de curtidas.
  • Chamadas da versão 11.0 e posteriores: o campo like_count é omitido caso o dono da mídia tenha ocultado o número de curtidas.

media_product_type
Público

Plataforma em que a mídia é publicada. Pode ser AD, FEED, STORY ou REELS.

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.

video_title
Público

Obsoleta. Omitido da resposta.

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.

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.

Exemplo de cURL

Solicitação

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

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.

Requisitos

TipoDescrição

Tokens de acesso

Usuário.

Permissões

instagram_basic
instagram_manage_comments
pages_show_list


Caso uma função na Página tenha sido concedida ao usuário do app por meio do Gerenciador de Negócios, você também precisará obter uma das seguintes:


ads_management
business_management

Sintaxe da solicitação

POST https://graph.facebook.com/{api-version}/{ig-media-id}
  ?comment_enabled={comment-enabled}
  &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

{comment-enabled}

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

Exemplo de cURL

Solicitação

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

Resposta

{
  "success": true
}

Exclusão

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