On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

Ottenere profili utente e contenuti multimediali utente

Questa guida spiega come ottenere il profilo e i contenuti multimediali di un utente Instagram.

Ottenere il profilo di un utente

Procedi come indicato di seguito per ottenere i dati del profilo (campi) di un utente Instagram.

Passaggio 1: ottenimento di un token d'accesso e delle autorizzazioni

Segui la nostra guida Ottenere token d'accesso e autorizzazioni per ottenere il token d'accesso utente Instagram di un utente. Avrai bisogno dell'autorizzazione instagram_graph_user_profile, quindi dovrai richiedere l'ambito user_profile quando ottieni l'autorizzazione dall'utente.

Passaggio 2: esecuzione di una query del nodo User

Invia una richiesta al seguente endpoint:

GET /me?fields={fields}&access_token={access-token}

Sostituisci {fields} con una lista separata da virgole di campi utente che desideri vengano restituiti e {access-token} con il token d'accesso dell'utente. L'endpoint GET /me determinerà l'ID dell'utente dal token e reindirizzerà la richiesta al nodo User.

Esempio di richiesta

curl -X GET \
  'https://graph.instagram.com/me?fields=id,username&access_token=IGQVJ...'

Esempio di risposta

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

Ottenere i contenuti multimediali di un utente

Procedi come indicato di seguito per ottenere una raccolta dei contenuti multimediali di un utente Instagram.

Passaggio 1: ottenimento di un token d'accesso e delle autorizzazioni

Segui la nostra guida Ottenere token d'accesso e autorizzazioni per ottenere il token d'accesso utente Instagram di un utente. Avrai bisogno di instagram_graph_user_profile e instagram_graph_user_media permissions, quindi dovrai richiedere gli ambiti user_profile e user_media quando ottieni l'autorizzazione dall'utente.

Passaggio 2: esecuzione di una query del segmento User Media

Invia una richiesta al seguente endpoint:

GET /me/media?fields={fields}&access_token={access-token}

Sostituisci {fields} con una lista separata da virgole di campi di contenuti multimediali che desideri vengano restituiti per ciascun contenuto multimediale incluso nella risposta (oppure ometti interamente il parametro fields se desideri che vengano restituiti solo ID) e {access-token} con il token d'accesso dell'utente. L'endpoint GET /me determinerà l'ID dell'utente dal token e reindirizzerà la richiesta al nodo User.

Esempio di richiesta

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

Esempio di risposta

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Ottenere dati sui contenuti multimediali

Procedi come indicato di seguito per ottenere i dati (campi) su un'immagine, un video o un album.

Passaggio 1: ottenimento di un token d'accesso e delle autorizzazioni

Segui la nostra guida Ottenere token d'accesso e autorizzazioni per ottenere il token d'accesso utente Instagram di un utente. Avrai bisogno dell'autorizzazione instagram_graph_user_media, quindi dovrai richiedere l'ambito user_media quando ottieni l'autorizzazione dall'utente.

Passaggio 2: esecuzione di una query del nodo Media

Invia una richiesta al seguente endpoint:

GET /{media-id}?fields={fields}&access_token={access-token}

Sostituisci {media-id} con l'ID dell'immagine, del video o dell'album che desideri interrogare, {fields} con una lista separata da virgole di campi di contenuti multimediali che desideri vengano restituiti e {access-token} con il token d'accesso dell'utente.

Esempio di richiesta

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

Esempio di risposta

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

Passaggio 2 (alternativo): esecuzione di una query del segmento User Media

Puoi interrogare il segmento User Media per ottenere una raccolta di contenuti multimediali dell'utente e utilizzare l'espansione dei campi per fare in modo che la risposta includa i campi di contenuti multimediali per ciascun contenuto multimediale nella raccolta. A tale scopo, invia una richiesta al seguente endpoint:

GET /me/media?fields={fields}&access_token={access-token}

Sostituisci {fields} con una lista separata da virgole di campi di contenuti multimediali che desideri vengano restituiti per ciascun contenuto multimediale nella raccolta e {access-token} con il token d'accesso dell'utente. L'endpoint GET /me determinerà l'ID dell'utente dal token e reindirizzerà la richiesta al nodo User.

Esempio di richiesta

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

Esempio di risposta

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Ottenere i contenuti di un album

Procedi come indicato di seguito per ottenere una raccolta di contenuti multimediali in formato immagine e video di un contenuto multimediale in formato album.

Passaggio 1: ottenimento di un token d'accesso e delle autorizzazioni

Segui la nostra guida Ottenere token d'accesso e autorizzazioni per ottenere il token d'accesso utente Instagram di un utente. Avrai bisogno dell'autorizzazione instagram_graph_user_media, quindi dovrai richiedere l'ambito user_media quando ottieni l'autorizzazione dall'utente.

Passaggio 2: esecuzione di una query del segmento Media Children

Invia una richiesta al seguente endpoint:

GET /{media-id}/children?fields={fields}&access_token={access-token}

Sostituisci {media-id} con l'ID dell'album che desideri interrogare, {fields} con una lista separata da virgole di campi di contenuti multimediali che desideri vengano restituiti per ciascun contenuto multimediale in formato immagine e video nella raccolta (oppure ometti interamente il parametro fields se desideri che vengano restituiti solo ID) e {access-token} con il token d'accesso dell'utente.

Esempio di richiesta

curl -X GET \
  'https://graph.instagram.com/17896450804038745/children?access_token=IGQVJ...'

Esempio di risposta

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "previous": "https://graph.faceb...",
    "next": "https://graph.faceb..."
  }
}