# `list_videos`

_Performance_

`read` `idempotent`

List the brand's published videos with metrics and classification (funnelStage, format, communicationStyle, mediaType). Filters: platform, since/until (ISO), funnelStage, format, minViews, mediaType (video|image|carousel). sortBy: views | engagement | published_at (desc). limit default 20 max 100, offset for paging. Captions are truncated to 300 chars; use get_video for full detail.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `brandId` | `string` | no |  |
| `platform` | `"tiktok" \| "instagram"` | no |  |
| `since` | `string` | no |  |
| `until` | `string` | no |  |
| `funnelStage` | `string` | no |  |
| `format` | `string` | no |  |
| `minViews` | `integer` | no |  |
| `mediaType` | `"video" \| "image" \| "carousel"` | no |  |
| `sortBy` | `"views" \| "engagement" \| "published_at"` | no |  |
| `limit` | `integer` | no |  |
| `offset` | `integer` | no |  |

## Example

### Prompt

```text
List my Instagram videos published this month sorted by views.
```

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_videos",
    "arguments": {
      "brandId": "3f6c2a4e-8b1d-4c7a-9e2f-5a1b0c9d8e7f",
      "platform": "tiktok"
    }
  }
}
```

### 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_videos","arguments":{"brandId":"3f6c2a4e-8b1d-4c7a-9e2f-5a1b0c9d8e7f","platform":"tiktok"}}}'
```