Skip to main content
GET
List Instagram media
Usa este endpoint para descubrir las publicaciones o las historias de una cuenta de Instagram. Pasa el UUID de la cuenta en la ruta y surface en la cadena de consulta. Tu clave de API necesita el alcance automations:read y acceso a esa cuenta. surface es obligatorio y acepta posts o stories. Cada elemento incluye id, surface, media_type, caption, thumbnail_url, instagram_url, published_at, like_count y comments_count. Todos los campos, salvo id y surface, pueden llegar como null cuando Instagram no devuelve un valor.

Referencia una publicación en un disparador

Un disparador de comentario puede vincularse a una publicación. Usa un id devuelto como valor de la referencia:
Un disparador de comentario también acepta la dirección pública de una publicación. Envía url como type de la referencia y la dirección como value. Un disparador de respuesta o de reacción a una historia solo acepta el tipo de referencia id, así que este endpoint es la forma de vincularlo. Lee Actualizar una automatización para conocer la forma completa del disparador.

Pagina los resultados

Define limit como un entero de 1 a 50. Cuando next_cursor sea una cadena, envíala sin cambios como cursor para pedir la página siguiente. Un next_cursor igual a null significa que la lista terminó. Esta lectura no cambia ninguna automatización, así que se puede repetir sin riesgo. Cuando no se puede acceder a Instagram, la API devuelve 503 con api_instagram_media_unavailable. Esa respuesta es temporal y no significa que la cuenta quedó inaccesible.

Solicitud de ejemplo

Autorizaciones

Authorization
string
header
requerido

Levios API key sent as a Bearer token.

Parámetros de ruta

accountId
string<uuid>
requerido

Parámetros de consulta

cursor
string
limit
string
surface
enum<string>
requerido
Opciones disponibles:
posts,
stories

Respuesta

Successful response.