---
title: "Get slideshows for a comet configuration"
method: GET
path: "/v1/comet/{id}/slideshows"
tags: ["Comet"]
---

# Get slideshows for a comet configuration

`GET /v1/comet/{id}/slideshows`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/comet/{id}/slideshows`
- Auth: HTTP bearer

Retrieves slideshows (image carousels) linked to a specific comet configuration.

## Path parameters

- `id` string, required

## Query parameters

- `limit` number
- `page` number
- `min_views` number
- `platforms` string[]
- `start_date` string
- `end_date` string
- `order_by` 'publish_date' | 'views' | 'created_at'
- `sort` 'asc' | 'desc'
- `intent_match` boolean

## Response `200`

Successfully retrieved slideshows

- CometSlideshowsResponseDto
  - `data` CometSlideshowsDataDto, required
    - `custom_niche_id` string, required
    - `custom_niche_name` string
    - `total` number, required
    - `limit` number, required
    - `offset` number, required
    - `slideshows` CometSlideshowItemDto[], required
      - `id` string, required
      - `url` string, required
      - `description` string, nullable
      - `hashtags` string[]: Hashtags array
      - `publish_date` string, nullable
      - `created_at` string, required
      - `views` number, required
      - `comments` number, required
      - `likes` number, required
      - `shares` number, required
      - `bookmarks` number, nullable
      - `thumbnail_url` string, nullable
      - `images` CometSlideshowImageDto[], required
        - `image_url` string, required
        - `position` number, required
      - `type` string, required: Platform type identifier
      - `author` V1AuthorDto
        - `username` string, required
        - `avatar_url` string, nullable, required: Creator avatar URL. Always an absolute URL (or null). Images Virlo stores are served from https://auth.virlo.ai/storage/v1/object/public/<bucket>/; platform CDN links are passed through. Some files are HEIC, which most non-Safari browsers cannot render, so convert before display if you need to.
        - `followers` number, required
        - `verified` boolean, required
        - `country` string, nullable: Creator's country (ISO-3166-1 alpha-2), when the platform exposes it. Distinct from a video's `upload_region`.
      - `linked_at` string, required
      - `intelligence` object, nullable: Per-slideshow AI intelligence payload (panel-text analysis, hook, brand safety, etc.). Slideshow intelligence is a separate schema from video intelligence — see the Data Intelligence docs. null when not ready or not requested — see `intelligence_status` for why.
      - `intelligence_status` 'ready' | 'pending' | 'disabled' | 'failed' | 'skipped': Disambiguates a null `intelligence` field: `ready` (use it), `pending` (still being generated — poll later or wait for webhook), `disabled` (parent comet didn't enable data_intelligence_enabled, so it will never arrive), `skipped` (deliberately not analyzed, so it will never arrive; see `intelligence_skip_reason`), `failed` (reserved for future use). Optional for backwards compatibility.
      - `intelligence_skip_reason` 'intent_mismatch' | 'too_old' | 'under_followers', nullable: Set only when `intelligence_status` is `skipped`: why Data Intelligence deliberately did not analyze this item, so its `intelligence` will never arrive. `intent_mismatch` (it does not match the agent's intent), `too_old` (published more than a year ago and not among the run's top performers), `under_followers` (more than two days old with no more views than its creator has followers). null otherwise.

## Other responses

- `401`: Unauthorized - missing or invalid API key
- `404`: Comet configuration not found
- `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)