Creazione

Questa operazione non è supportata.

Lettura

GET /{ig-user-id}

Consente di ottenere campi e segmenti su un account business o creator di Instagram.

Requisiti

TipoDescrizione

Token d'accesso

Utente.

Ruoli business

Se stai richiedendo il campo shopping_product_tag_eligibility per i tag dei prodotti, l'utente dell'app deve disporre di un ruolo di amministratore nel Business Manager che possiede lo Shop di Instagram dell'utente di IG.

Shop di Instagram

Se stai richiedendo il campo shopping_product_tag_eligibility per i tag dei prodotti, l'utente di IG deve disporre di uno Shop di Instagram approvato con un catalogo prodotti contenente dei prodotti.

Autorizzazioni

instagram_basic
pages_read_engagement
pages_show_list


Se all'utente dell'app è stato concesso un ruolo sulla Pagina tramite Business Manager, è necessaria anche una delle seguenti autorizzazioni:


ads_management
business_management


Se stai richiedendo il campo shopping_product_tag_eligibility per i tag dei prodotti, avrai bisogno anche delle seguenti autorizzazioni:


catalog_management
instagram_shopping_tag_products

Sintassi della richiesta

GET https://graph.facebook.com/{api-version}/{ig-user-id}
  ?fields={fields}
  &access_token={access-token}

Parametri del percorso

SegnapostoValore

{api-version}

Versione API.

{ig-user-id}

Obbligatorio. ID utente di IG.

Parametri della stringa della query

ChiaveSegnapostoValore

access_token

{access-token}

Obbligatorio. Token d'accesso utente dell'utente dell'app.

fields

{fields}

Lista separata da virgole dei campi dell'utente di IG che desideri vengano restituiti nell'insieme dei risultati per ciascun utente di IG.

Campi

I campi pubblici possono essere restituiti da un segmento usando l'espansione dei campi.

Nome del campoDescrizione

biography
Pubblico

Testo della biografia del profilo.

id
Pubblico

ID utente per singola app.

ig_id

ID utente Instagram. Usato con l'API Instagram precedente, ora obsoleto. Usa invece id.

followers_count
Pubblico

Numero totale di utenti Instagram che seguono l'utente.

follows_count

Numero totale di utenti Instagram seguiti dall'utente.

media_count
Pubblico

Numero totale di contenuti multimediali di IG pubblicati sull'utente.

name

Nome del profilo.

profile_picture_url

URL dell'immagine del profilo.

shopping_product_tag_eligibility

Restituisce true se l'utente dell'app ha configurato uno shop di Instagram ed è quindi idoneo per il tag del prodotto, altrimenti restituisce false.

username
Pubblico

Nome utente del profilo.

website
Pubblico

URL del sito web del singolo profilo.

Segmenti

SegmentoDescrizione

business_discovery

Consente di ottenere dati su altri utenti di IG creator o business di Instagram.

content_publishing_limit

Rappresenta l'utilizzo attuale della pubblicazione dei contenuti di un utente di IG.

insights

Rappresenta le metriche delle interazioni social su un utente di IG.

live_media

Rappresenta una raccolta di contenuti multimediali di IG di tipo video in diretta su un utente di IG.

media

Rappresenta una raccolta di contenuti multimediali di IG su un utente di IG.

media_publish

Pubblica un contenitore di IG su un utente di IG business di Instagram.

mentions

Crea un commento di IG su un commento di IG o un contenuto multimediale di IG con didascalia in cui un altro utente Instagram ha @menzionato l'utente di IG.

mentioned_comment

Consente di ottenere dati su un commento di IG in cui un utente di IG è stato @menzionato da un altro utente Instagram.

mentioned_media

Consente di ottenere dati su un contenuto multimediale di IG in cui un utente di IG è stato @menzionato in una didascalia da un altro utente Instagram.

recently_searched_hashtags

Consente di ottenere gli hashtag di IG che un utente di IG ha cercato negli ultimi 7 giorni.

stories

Rappresenta una raccolta di oggetti di tipo contenuto multimediale di IG in una storia su un utente di IG.

tags

Rappresenta una raccolta di contenuti multimediali di IG in cui un utente di IG è stato taggato da un altro utente Instagram.

Risposta

Un oggetto JSON contenente campi e segmenti predefiniti e obbligatori.

{
  "{field}":"{value}",
  ...
}

Esempio di cURL

Richiesta

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

Risposta

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.