API de visualización básica de Instagram

Contenido multimedia del usuario

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

Creación

Esta operación no se admite.

Lectura

GET /{user-id}/media

Permite obtener una colección de contenido multimedia en un usuario.

Limitaciones

  • Las historias no se admiten.
  • Las publicaciones promocionadas con contenido multimedia no se admiten.
  • Devuelve un máximo de 10 000 elementos del contenido multimedia más reciente.

Requisitos

TipoRequisito

Identificadores 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}
Cadena
obligatoria

Identificador de usuario específico de la aplicación (a partir de la versión 11) o identificador de usuario sin formato (todas las versiones) del usuario de la aplicación.

Parámetros de la cadena de consulta

Incluye los siguientes parámetros de la cadena de la consulta para ampliar la solicitud.

ClaveValor

access_token
Cadena
obligatoria

Identificador de acceso de usuario de Instagram del usuario de la aplicación.

fields
Lista de valores separados por comas

Lista separada por comas de los campos multimedia que quieres que devuelva la expansión de campo para cada nodo multimedia en el conjunto de resultados.

{since}
Marca de tiempo

Marca de tiempo Unix o valor de datos strtotime que señala al inicio de un intervalo de datos basado en tiempo. Consulta la paginación basada en tiempo.

{until}
Marca de tiempo

Marca de tiempo Unix o valor de datos strtotime que señala al final de un intervalo de datos basado en tiempo. Consulta la paginación basada en tiempo.

Respuesta

Objeto con formato JSON que contiene los datos solicitados.

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

Contenido de la respuesta

PropiedadValor

data

Matriz de contenido multimedia en el usuario.

paging

Objeto que contiene cursores de paginación y URL para recuperar el conjunto de datos anterior y el siguiente.

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

Esta operación no se admite.

Eliminación

Esta operación no se admite.