Plataforma do Instagram

Descoberta de empresas

É possível usar a Graph API do Instagram para obter métricas e metadados básicos sobre outras contas empresariais e de criador de conteúdo do Instagram.

Limitações

Não serão retornados dados sobre contas empresariais 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.

Exemplos

Como obter a contagem de seguidores e de mídias de uma conta

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

Exemplo de solicitação

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count}&access_token={access-token}"

Exemplo de resposta

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram Account ID
  },
  "id": "17841405309211844"  // ID of the Instagram account performing the query
}

Como obter mídias

Já que é possível executar solicitações aninhadas ao especificar uma borda por meio do parâmetro fields, você pode solicitar a borda media da conta empresarial ou de criador de conteúdo do Instagram para obter todos os respectivos objetos de mídia publicados:

Exemplo de solicitação

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media}&access_token={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"
}

Como obter métricas básicas sobre as 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

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}}&access_token={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"
}