---
title: "Paginated posts for a satellite run (sortable + filterable)"
method: GET
path: "/v1/satellite/runs/{run_id}/videos"
tags: ["Satellite"]
---

# Paginated posts for a satellite run (sortable + filterable)

`GET /v1/satellite/runs/{run_id}/videos`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/satellite/runs/{run_id}/videos`
- Auth: HTTP bearer

Pages the posts of any satellite run your team owns — the deliverable way to read a large run without loading the whole (up to ~300-post, multi-hundred-KB) blob from GET /runs/:run_id. Each entry carries its `intelligence` (and, for carousels, `slides` + per-slide OCR `panel_texts`) when the run opted into data_intelligence. Each slide is `{ position, image_url }`; `image_url` is a full URL (Virlo storage or a platform CDN link), and some files are HEIC. Optional `sort` (recent | popular) and `content_type` (video | slideshow | all). Free to call.

## Path parameters

- `run_id` string, required

## Query parameters

- `limit` number
- `offset` number
- `sort` 'recent' | 'popular'
- `content_type` 'all' | 'video' | 'slideshow'

## Response `200`

Slice returned

- GetRunVideosResponseDto
  - `data` GetRunVideosResponseDataDto, required
    - `videos` object[], required
    - `total` number, required: Total matching posts AFTER the content_type filter.
    - `limit` number, required
    - `offset` number, required
    - `sort` 'recent' | 'popular', nullable: The sort that was applied, or null for original order.
    - `content_type` 'all' | 'video' | 'slideshow', required: The content_type filter that was applied.

## Other responses

- `401`: Unauthorized - missing or invalid API key
- `404`: Run not found or not owned by your team
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)