# `list_creator_videos`

_Viral catalog_

`read` `idempotent`

List ONLY one catalog creator's videos, without their profile, general analysis, video analyses or transcripts. Accounts are matched by platform AND handle. Defaults to every video language, sorted by views; supports recent/engagement, format, platform, minViews and pagination. Follow nextOffset; call get_catalog_video for analysis + transcript of selected videos and get_creator_analysis separately for the creator's general analysis. Does not scrape or generate anything.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `brandId` | `string` | no |  |
| `creatorId` | `string` | yes |  |
| `platform` | `"instagram" \| "tiktok"` | no |  |
| `sortBy` | `"views" \| "recent" \| "engagement"` | no |  |
| `language` | `string` | no |  |
| `format` | `"talking_head" \| "voiceover_broll" \| "listicle" \| "tutorial" \| "storytelling" \| "reaction" \| "pov" \| "street_interview" \| "day_in_life" \| "podcast_clip" \| "green_screen"` | no |  |
| `minViews` | `integer` | no |  |
| `limit` | `integer` | no |  |
| `offset` | `integer` | no |  |

## Example

### Prompt

```text
List this creator's latest 20 videos, without loading their general analysis.
```

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_creator_videos",
    "arguments": {
      "creatorId": "3f6c2a4e-8b1d-4c7a-9e2f-5a1b0c9d8e7f",
      "sortBy": "recent",
      "limit": 20
    }
  }
}
```

### curl

```bash
curl -X POST https://app.usedalea.ai/api/mcp/mcp \
  -H "Authorization: Bearer dalea_mcp_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_creator_videos","arguments":{"creatorId":"3f6c2a4e-8b1d-4c7a-9e2f-5a1b0c9d8e7f","sortBy":"recent","limit":20}}}'
```
