> ## Documentation Index > Fetch the complete documentation index at: https://docs.levios.app/llms.txt > Use this file to discover all available pages before exploring further. # Listar medios de Instagram > Lista las publicaciones o las historias de una cuenta de Instagram para que el disparador de una automatización pueda referenciar una publicación concreta por su ID de medio. 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: ```json theme={null} { "publication": { "mode": "specific", "reference": { "type": "id", "value": "" } } } ``` 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](/es/api/v1/automations/update) 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 ```bash theme={null} curl --get \ --url "https://levios.app/api/v1/accounts/${LEVIOS_ACCOUNT_ID}/media" \ --header "Authorization: Bearer ${LEVIOS_API_KEY}" \ --data-urlencode 'surface=posts' \ --data-urlencode 'limit=25' ``` ## OpenAPI ````yaml openapi/v1.json GET /api/v1/accounts/{accountId}/media openapi: 3.1.0 info: title: levios public API version: '1' servers: - url: https://levios.app security: - bearerAuth: [] paths: /api/v1/accounts/{accountId}/media: get: tags: - account_media summary: List Instagram media description: >- Returns a cursor-paginated list of posts or stories for one Instagram account. operationId: accounts.media.list parameters: - name: accountId in: path required: true schema: type: string format: uuid - name: cursor in: query required: false schema: type: string - name: limit in: query required: false schema: type: string - name: surface in: query required: true schema: type: string enum: - posts - stories responses: '200': description: Successful response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: $ref: '#/components/schemas/PublicInstagramMediaPageV1' '400': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: oneOf: - type: object properties: error: type: object properties: code: type: string enum: - api_invalid_content_length correlation_id: type: string message: type: string enum: - Invalid Content-Length. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_invalid_json correlation_id: type: string message: type: string enum: - The request body is not valid JSON. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_invalid_request_url correlation_id: type: string message: type: string enum: - The request URL is invalid. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_invalid_utf8 correlation_id: type: string message: type: string enum: - The request body is not valid UTF-8. required: - code - message additionalProperties: false required: - error additionalProperties: false '401': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ WWW-Authenticate: description: API key Bearer challenge. schema: type: string enum: - Bearer content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - api_unauthorized correlation_id: type: string message: type: string enum: - Authentication required. required: - code - message additionalProperties: false required: - error additionalProperties: false '403': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: oneOf: - type: object properties: error: type: object properties: code: type: string enum: - api_account_not_granted correlation_id: type: string message: type: string enum: - >- This credential is not authorized for the request. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_forbidden correlation_id: type: string message: type: string enum: - >- This credential is not authorized for the request. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_scope_denied correlation_id: type: string message: type: string enum: - >- This credential is not authorized for the request. required: - code - message additionalProperties: false required: - error additionalProperties: false '404': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - api_automation_media_not_found correlation_id: type: string message: type: string enum: - The referenced Instagram media was not found. required: - code - message additionalProperties: false required: - error additionalProperties: false '413': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: oneOf: - type: object properties: error: type: object properties: code: type: string enum: - api_body_too_large correlation_id: type: string message: type: string enum: - The JSON request body exceeds 1 MiB. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_json_too_deep correlation_id: type: string message: type: string enum: - The JSON request body exceeds maximum depth. required: - code - message additionalProperties: false required: - error additionalProperties: false '415': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - api_unsupported_media_type correlation_id: type: string message: type: string enum: - Content-Type must be application/json. required: - code - message additionalProperties: false required: - error additionalProperties: false '422': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: oneOf: - type: object properties: error: type: object properties: code: type: string enum: - api_automation_invalid_configuration correlation_id: type: string message: type: string enum: - >- Configuration fields do not match the public automation contract. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_invalid_cursor correlation_id: type: string message: type: string enum: - >- The projection cursor is invalid for this resource. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_invalid_limit correlation_id: type: string message: type: string enum: - >- The page limit must be an integer between 1 and 50. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_validation_error correlation_id: type: string details: type: object properties: issues: type: array items: type: object properties: code: type: string minLength: 1 maxLength: 64 path: type: array items: type: integer minimum: 0 maxItems: 16 required: - code - path additionalProperties: false maxItems: 32 required: - issues additionalProperties: false message: type: string enum: - The request does not match the declared schema. required: - code - message additionalProperties: false required: - error additionalProperties: false '429': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ Retry-After: description: Seconds to wait before retrying. schema: type: integer minimum: 1 content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - rate_limited correlation_id: type: string message: type: string enum: - Rate limit exceeded. required: - code - message additionalProperties: false required: - error additionalProperties: false '500': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - api_internal_error correlation_id: type: string message: type: string enum: - The request could not be completed. required: - code - message additionalProperties: false required: - error additionalProperties: false '503': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: oneOf: - type: object properties: error: type: object properties: code: type: string enum: - api_account_resolution_unavailable correlation_id: type: string message: type: string enum: - The reachable account set could not be read. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_instagram_media_unavailable correlation_id: type: string message: type: string enum: - Instagram media is temporarily unavailable. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - rate_limiter_unavailable correlation_id: type: string message: type: string enum: - Rate limiter unavailable. required: - code - message additionalProperties: false required: - error additionalProperties: false components: schemas: PublicInstagramMediaPageV1: $ref: 3ba73f4a-fdb6-46f1-8f12-bd09040a5db6 $defs: PublicInstagramMediaPageV1: additionalProperties: false properties: items: items: additionalProperties: false properties: caption: anyOf: - pattern: ^(?![\s\S]*[\u0000\uD800-\uDFFF])[\s\S]{1,2200}$ type: string - type: 'null' comments_count: anyOf: - maximum: 9007199254740991 minimum: 0 type: integer - type: 'null' id: pattern: ^[!-~]{1,256}$ type: string instagram_url: anyOf: - format: uri maxLength: 2048 type: string - type: 'null' like_count: anyOf: - maximum: 9007199254740991 minimum: 0 type: integer - type: 'null' media_type: anyOf: - enum: - image - video - carousel type: string - type: 'null' published_at: anyOf: - format: date-time type: string - type: 'null' surface: enum: - posts - stories type: string thumbnail_url: anyOf: - format: uri maxLength: 2048 type: string - type: 'null' required: - id - surface - media_type - caption - thumbnail_url - instagram_url - published_at - like_count - comments_count type: object maxItems: 50 type: array next_cursor: anyOf: - maxLength: 1024 minLength: 1 type: string - type: 'null' required: - items - next_cursor type: object $id: https://levios.app/schemas/public-instagram-media-page-v1 $schema: https://json-schema.org/draft/2019-09/schema# title: PublicInstagramMediaPageV1 x-levios-max-serialized-bytes: 65536 x-levios-schema-version: 1 securitySchemes: bearerAuth: type: http scheme: bearer description: Levios API key sent as a Bearer token. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.