Aziende suggerite

Puoi utilizzare l'API Instagram con Facebook Login per ottenere metadati e metriche di base su altri account per professionisti Instagram.

Limitazioni

I dati sugli account per professionisti 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 /<YOUR_APP_USERS_IG_USER_ID>/business_discovery

Esempi

Acquisisci numero di follower e contenuti multimediali

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 per professionisti Instagram dell'utente dell'app (in questo caso, 17841405309211844), non sul nome utente dell'account per professionisti Instagram di cui l'utente dell'app sta tentando di ottenere i dati (bluebottle in questo esempio).

Esempio di richiesta

Formattato per una maggiore leggibilità.

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

Esempio di risposta

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

Acquisisci contenuti multimediali

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

Esempio di richiesta

Formattato per una maggiore leggibilità.

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

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

Acquisisci 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

Formattato per una maggiore leggibilità.

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

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