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
Atualização em Português (Brasil): 5 de ago de 2022

Changelog

September 4, 2024

Announcing deprecation of Instagram Basic Display API. In 90 days, on December 4, 2024, the Instagram Basic Display API will no longer be available.

June 28, 2022

Reels

Aplicável a todas as versões.

Agora as respostas a GET /{user-id}/media incluem vídeos do Reels. Entretanto, não é possível verificar se um vídeo no conjunto de respostas foi designado como Reels.

June 27, 2022

Documentação da API do Instagram legada

Aplicável a todas as versões.

A documentação para desenvolvedores sobre a API do Instagram legada foi removida. Agora, a página redireciona para a documentação para desenvolvedores da plataforma do Instagram.

August 30, 2021

Atividade fora do Facebook

Aplicável a todas as versões.

As alterações de 15 de junho de 2021 relacionadas à ação de limpar histórico e às configurações de atividades futuras que tinham sido pausadas em meados de julho, agora foram retomadas.

June 30, 2021

Tokens de acesso para contas privadas

Aplicável a todas as versões.

Agora é possível atualizar os tokens de acesso de longa duração para contas privadas do Instagram. Além disso, as permissões concedidas a aplicativos por usuários com contas privadas passam a ser válidas por 90 dias.

June 15, 2021

Atividade fora do Facebook

Aplicável a todas as versões.

Os usuários que apagarem o histórico ou desativarem atividades futuras invalidarão os próprios tokens de acesso. Além disso, os usuários com atividades futuras desativadas que tentarem usar a janela de autorização receberão um aviso para ativar as atividades futuras se quiserem usar o aplicativo.

June 8, 2021

Access Token Debugger

Applies to all versions.

The access token debugger tool now only returns an app-scoped ID when debugging a token.


API Versioning

Applies to all versions.

The API now supports versioned calls. To query a specific API version include the version number in the query path after the base URL. For example:

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

Un-versioned requests (missing the version number) resolve to the version specified in the calling app's App Dashboard > Settings > Advanced > Upgrade API Version section.


App Scoped User IDs

Applies to version 11.0+.

App-scoped user IDs (ASIDs) have been introduced. ASIDs will replace raw user IDs in approximately two years, when version 10.0 is deprecated, so we recommend that you begin mapping your app users' raw IDs to their ASID equivalents.

  • All versions support raw user ID based queries.
  • Only version 11.0+ calls support ASID based queries.
  • Version 11.0+ calls will receive ASIDs in responses, even when querying raw user IDs.

Time-based Pagination

Applies to v11.0+.

Added since and until parameters to the GET /{user-id}/media endpoint to support time-based pagination.

October 24, 2020

  • User Node — The ig_id field, which returned the app user's Instagram Legacy User ID, has been deprecated.

August 31, 2020

June 5, 2020

  • Legacy IDs — You can now request the ig_id field on the User node to get the app user's Instagram Legacy API User ID. This field will be available until September 30th, 2020. (UPDATE: Available until October 24, 2020).

February 20, 2020

January 14, 2020

December 6, 2019

October 15, 2019

Instagram Basic Display API has officially launched!