---
title: "List generated snacks"
method: GET
path: "/api/v1/snacks"
tags: ["Snacks"]
---

# List generated snacks

`GET /api/v1/snacks`

## Request

- Base URL: `https://www.vidguy.ai`
- URL: `https://www.vidguy.ai/api/v1/snacks`
- Auth: HTTP bearer

Returns the partner's snack posts, optionally filtered by `brandId`. Each entry includes the full manifest.

## Query parameters

- `brandId` string
- `limit` integer
- `offset` integer

## Response `200`

List of snack posts.

- SnacksListResponse
  - `snacks` SnackPost[], required
    - `id` string, required
    - `brandId` string, nullable, required
    - `name` string, required
    - `status` string, required
    - `manifest` SnackPostManifest, required: Render-agnostic JSON description of a snack post. Each `snacks[]` entry contains scenes, visual URLs, text overlays, and audio.
      - `version` 1, required
      - `aspectRatio` '9:16' | '1:1' | '16:9', required
      - `snacks` object[], required
    - `createdAt` string, required
    - `updatedAt` string, required
  - `pagination` object, required
    - `limit` integer, required
    - `offset` integer, required

## Other responses

- `400`: Invalid query.
- `401`: Missing or invalid API key.

---

[API](https://skmtc.dev/vidguy/apis/vidguy-snacks-api.md) · [All operations](https://skmtc.dev/vidguy/apis/vidguy-snacks-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vidguy/apis/vidguy-snacks-api/revisions/ad6855539a1a?raw)