API Instagram Basic Display

Contenuto multimediale dell'utente

Rappresenta una raccolta di contenuti multimediali di un utente.

Creazione

Questa operazione non è supportata.

Lettura

GET /{user-id}/media

Ottieni una raccolta di contenuti multimediali di un utente.

Limitazioni

  • Le storie non sono supportate.
  • I contenuti multimediali nei post promossi non sono supportati.
  • Restituisce un massimo di 10 000 tra i più recenti contenuti multimediali creati.

Requisiti

TipoRequisito

Token d'accesso

Utente Instagram

Autorizzazioni

instagram_graph_user_media, instagram_graph_user_profile

Sintassi della richiesta

GET https://graph.instagram.com/{api-version}/{user-id}/media
  ?access_token={access-token}

Parametri del percorso

PlaceholderValore

{api-version}
Stringa

Versione API.

{user-id}
Obbligatoria
Stringa

ID utente per singola app dell'utente dell'app (versione 11.0 e successive) o ID utente raw (tutte le versioni).

Parametri della stringa della query

Includono i seguenti parametri della stringa della query per potenziare la richiesta.

CodiceValore

access_token
Obbligatoria
Stringa

Il token d'accesso dell'utente Instagram dell'utente dell'app.

fields
Lista separata da virgole

Una lista separata da virgole di campi di contenuti multimediali che desideri vengano restituiti dall'espansione dei campi per ciascun nodo dei contenuti multimediali nella raccolta di risultati.

Marca temporalesince

Una marca temporale Unix o un valore dati strtotime che punta all'inizio di un intervallo di dati basati sull'ora. Consulta paginazione basata sull'ora.

Marca temporaleuntil

Una marca temporale Unix o un valore dati strtotime che punta alla fine di un intervallo di dati basati sull'ora. Consulta paginazione basata sull'ora.

Risposta

Un oggetto con formato JSON contenente i dati richiesti.

{
  "data": [],
  "paging": {}
}

Contenuti della risposta

ProprietàValore

data

Un array di contenuti multimediali dell'utente.

paging

Un oggetto contenente i cursori di paging e gli URL di recupero della raccolta di dati successivi/precedenti.

Esempio di cURL

Richiesta

curl -X GET \
  'https://graph.instagram.com/v19.0/10218560180051171/media?access_token=IGQVJ...'

Risposta

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

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.