Aziende suggerite

Puoi utilizzare l'API Instagram Graph per ottenere metadati e metriche di base su altri account business e creator di Instagram.

Limitazioni

I dati sugli account business di Instagram con restrizioni in base all'età non verranno restituiti.

Endpoint

L'API si compone degli endpoint seguenti. Consulta la documentazione di riferimento dell'endpoint per i requisiti relativi a parametri e autorizzazioni.

• GET /{ig-user-id}/business_discovery

Esempi

Acquisizione di numero di follower e contenuti multimediali di un account

Questa query di esempio mostra come ottenere il numero di follower e di elementi multimediali pubblicati sull'account business di Instagram Blue Bottle Coffee. Tieni presente che le query di Aziende suggerite vengono eseguite sull'ID dell'account business o creator di Instagram (in questo caso, 17841405309211844), non sul nome utente dell'account business o creator di Instagram di cui stai tentando di ottenere i dati (bluebottle in questo esempio).

Esempio di richiesta

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

Esempio di risposta

{
  "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
}

Acquisizione di contenuti multimediali

Poiché è possibile effettuare richieste nidificate specificando un segmento tramite il parametro fields, è possibile richiedere il segmento media dell'account business o creator targetizzato per ottenere tutti i suoi elementi multimediali pubblicati:

Esempio di richiesta

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}"

Esempio di risposta

{
  "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"
}

Acquisizione delle metriche di base sui contenuti multimediali

Puoi utilizzare sia le richieste nidificate sia l'espansione dei campi per ottenere campi pubblici per gli elementi multimediali di un account business o creator. Tieni presente che tale condizione non ti concede l'autorizzazione per l'accesso diretto agli elementi multimediali, pertanto l'esecuzione di GET su qualsiasi contenuto multimediale di IG restituito non andrà a buon fine a causa di autorizzazioni insufficienti.

Ad esempio, ecco come ottenere il numero di commenti e "Mi piace" per ciascuno degli elementi multimediali pubblicati da Blue Bottle Coffee:

Esempio di richiesta

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}"

Esempio di risposta

{
  "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"
}