List Clips

GET https://app.resemble.ai/api/v2/projects/{project_uuid}/clips

Query Parameters

Parameter	Type	Required	Notes
`q`	string	❌	Search query to filter clips by title.
`page`	integer	❌	Page number for pagination.
`page_size`	integer	❌	Number of items per page.

Example Request

$ curl 'https://app.resemble.ai/api/v2/projects/PROJECT_UUID/clips?page=1&page_size=10&q=intro' \
>   -H 'Authorization: Bearer YOUR_API_TOKEN'

Response

1 {
2   "success": true,
3   "page": 1,
4   "total_results": 25,
5   "page_count": 3,
6   "items": [
7     {
8       "uuid": "CLIP_UUID",
9       "title": "Intro",
10       "body": "Welcome to our show",
11       "voice_uuid": "VOICE_UUID",
12       "voice_name": "Professional Voice",
13       "is_archived": false,
14       "audio_src": "https://...",
15       "character_count": 20,
16       "duration": 2.5,
17       "last_generated_at": "2024-01-15T10:32:00Z",
18       "timestamps": {
19         "graph_chars": ["W", "e", "l", "c", "o", "m", "e"],
20         "graph_times": [[0, 120], [120, 240], ...],
21         "phon_chars": [],
22         "phon_times": []
23       },
24       "created_at": "2024-01-15T10:30:00Z",
25       "updated_at": "2024-01-15T10:32:00Z"
26     }
27   ]
28 }

Note: Clips created via the UI return limited fields until the “Create All” button finalizes synthesis. UI-generated clips containing multiple voices return a comma-separated voice_uuid list (e.g., "4fe4e18e,922705cb"). API-created clips include full metadata immediately.

$	curl 'https://app.resemble.ai/api/v2/projects/PROJECT_UUID/clips?page=1&page_size=10&q=intro' \
>	-H 'Authorization: Bearer YOUR_API_TOKEN'

1	{
2	"success": true,
3	"page": 1,
4	"total_results": 25,
5	"page_count": 3,
6	"items": [
7	{
8	"uuid": "CLIP_UUID",
9	"title": "Intro",
10	"body": "Welcome to our show",
11	"voice_uuid": "VOICE_UUID",
12	"voice_name": "Professional Voice",
13	"is_archived": false,
14	"audio_src": "https://...",
15	"character_count": 20,
16	"duration": 2.5,
17	"last_generated_at": "2024-01-15T10:32:00Z",
18	"timestamps": {
19	"graph_chars": ["W", "e", "l", "c", "o", "m", "e"],
20	"graph_times": [[0, 120], [120, 240], ...],
21	"phon_chars": [],
22	"phon_times": []
23	},
24	"created_at": "2024-01-15T10:30:00Z",
25	"updated_at": "2024-01-15T10:32:00Z"
26	}
27	]
28	}