Descoberta de empresas

É possível usar a API do Instagram com o Login do Facebook para obter metadados e métricas básicos sobre outras contas profissionais do Instagram.

Limitações

Não serão retornados dados sobre contas profissionais do Instagram com restrição de idade.

Pontos de extremidade

A API consiste nos pontos de extremidade a seguir. Consulte a documentação de referência do ponto de extremidade para ver requisitos de parâmetros e permissões.

• GET /<YOUR_APP_USERS_IG_USER_ID>/business_discovery

Exemplos

Obter o número de seguidores e de mídias

Este exemplo de consulta demonstra como obter o número de seguidores e de objetos de mídia publicados na conta profissional da Blue Bottle Coffee no Instagram. As consultas de descoberta de empresas são executadas com a identificação da conta profissional do Instagram do usuário do app (nesse caso, 17841405309211844) sobre a qual você quer obter dados, não com o nome de usuário (nesse exemplo, bluebottle).

Exemplo de solicitação

Texto formatado para facilitar a leitura.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

Exemplo de resposta

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram user ID
  },
  "id": "17841405309211844"  // Your app user's Instagram user ID
}

Obter mídias

Já que é possível executar solicitações aninhadas ao especificar uma borda por meio do parâmetro fields, solicite a borda media da conta profissional em questão para obter todos os respectivos objetos de mídia publicados.

Exemplo de solicitação

Texto formatado para facilitar a leitura.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

Exemplo de resposta

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        ... // results truncated for brevity
      ],
    "id": "17841401441775531"
  },
  },
  "id": "17841405309211844"
}

Obter métricas básicas sobre mídias

É possível usar solicitações aninhadas ou uma expansão de campo para obter campos públicos dos objetos de mídia de uma conta empresarial ou de criador de conteúdo do Instagram. Observe que isso não concede permissão para acessar diretamente os objetos de mídia. Haverá falhas ao executar GET em qualquer mídia do Instagram retornada devido a permissões insuficientes.

Por exemplo, veja como obter o número de comentários e curtidas para todos os objetos de mídia publicados pela Blue Bottle Coffee:

Exemplo de solicitação

Texto formatado para facilitar a leitura.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

Exemplo de resposta

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5841,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2998,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3644,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
        {
          "comments_count": 60,
          "like_count": 9347,
          "id": "17899363132086521"
        },
        {
          "comments_count": 63,
          "like_count": 6913,
          "id": "17893114378137541"
        },
        {
          "comments_count": 16,
          "like_count": 2791,
          "id": "17886057709171561"
        },
        {
          "comments_count": 15,
          "like_count": 3895,
          "id": "17856337633208377"
        },
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405976406927"
}