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.
Questa guida spiega come ottenere il profilo e i contenuti multimediali di un utente Instagram.
Procedi come indicato di seguito per ottenere i dati del profilo (campi) di un utente Instagram.
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.
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.
curl -X GET \ 'https://graph.instagram.com/me?fields=id,username&access_token=IGQVJ...'
{ "id": "17841405793187218", "username": "jayposiris" }
Procedi come indicato di seguito per ottenere una raccolta dei contenuti multimediali di un utente Instagram.
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.
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.
curl -X GET \ 'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'
{ "data": [ { "id": "17895695668004550", "caption": "" }, { "id": "17899305451014820", "caption": "" }, { "id": "17896450804038745", "caption": "" }, { "id": "17881042411086627", "caption": "" } ], "paging": { "cursors": { "after": "MTAxN...", "before": "NDMyN..." }, "next": "https://graph.faceb..." } }
Procedi come indicato di seguito per ottenere i dati (campi) su un'immagine, un video o un album.
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.
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.
curl -X GET \ 'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'
{ "id": "17895695668004550", "media_type": "IMAGE", "media_url": "https://fb-s-b-a.akamaihd.net/...", "username": "jayposiris" "timestamp": "2017-08-31T18:10:00+0000" }
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.
curl -X GET \ 'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'
{ "data": [ { "id": "17895695668004550", "caption": "" }, { "id": "17899305451014820", "caption": "" }, { "id": "17896450804038745", "caption": "" }, { "id": "17881042411086627", "caption": "" } ], "paging": { "cursors": { "after": "MTAxN...", "before": "NDMyN..." }, "next": "https://graph.faceb..." } }
Procedi come indicato di seguito per ottenere una raccolta di contenuti multimediali in formato immagine e video di un contenuto multimediale in formato album.
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.
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.
curl -X GET \ 'https://graph.instagram.com/17896450804038745/children?access_token=IGQVJ...'
{ "data": [ { "id": "17880997618081620" }, { "id": "17871527143187462" } ], "paging": { "cursors": { "after": "MTAxN...", "before": "NDMyN..." }, "previous": "https://graph.faceb...", "next": "https://graph.faceb..." } }