API de visualización básica de Instagram

Contenido multimedia del usuario

Representa una colección de contenido multimedia de un usuario.

Creación

No se admite esta operación.

Lectura

GET /{user-id}/media

Se usa para obtener una colección de contenido multimedia de un usuario.

Limitaciones

  • Las historias no son compatibles.
  • No se admite contenido multimedia de publicaciones promocionadas.
  • Devuelve un máximo de 10.000 instancias del contenido multimedia más reciente.

Requisitos

TipoRequisito

Tokens de acceso

Usuario de Instagram

Permisos

instagram_graph_user_media, instagram_graph_user_profile

Sintaxis de la solicitud

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

Parámetros de ruta

Marcador de posiciónValor

{api-version}
Cadena

Versión de la API.

{user-id}
Obligatorio
Cadena

Identificador de usuario específico de la app (versión 11.0 o posterior) o identificador de usuario sin procesar (todas las versiones).

Parámetros de la cadena de la consulta

Incluye los siguientes parámetros en la cadena de consulta para hacer una solicitud más compleja.

ClaveValor

access_token
Cadena obligatoria

Token de acceso de usuario de Instagram del usuario de la app.

fields
Lista separada por comas

Lista separada por comas de los campos multimedia que quieres que field-expansion devuelva por cada nodo multimedia del conjunto de resultados.

since
Marca de tiempo

Una marca de tiempo UNIX o valor de datos strtotime que apunta al inicio de un intervalo de datos con marcas de tiempo. Consulta la paginación basada en el tiempo.

until
Marca de tiempo

Una marca de tiempo UNIX o valor de datos strtotime que apunta al final de un intervalo de datos con marcas de tiempo. Consulta la paginación basada en el tiempo.

Respuesta

Objeto con formato JSON que contiene los datos solicitados.

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

Contenido de la respuesta

PropiedadValor

data

Matriz del contenido multimedia de un usuario.

paging

Objeto que contiene cursores de paginación y URL de recuperación de conjuntos de datos siguientes/anteriores.

Ejemplo de cURL

Solicitud

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

Respuesta

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

Actualización

No se admite esta operación.

Eliminación

No se admite esta operación.