Skip to main content
GET
/
api
/
list
cURL
curl --request GET \
  --url https://api.transcribetube.com/api/list \
  --header 'api-key: <api-key>'
[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "Rick Astley - Never Gonna Give You Up",
    "youtubeId": "dQw4w9WgXcQ",
    "state": "upload",
    "createdAt": "2023-11-07T05:31:56Z"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.transcribetube.com/llms.txt

Use this file to discover all available pages before exploring further.

List all projects belonging to the API user, newest first, in pages of 100.

​
Request

Query paramTypeDefaultDescription
pageinteger ≥ 11Page number. Page size is fixed at 100.

​
Examples

curl "https://api.transcribetube.com/api/list?page=1" \
  -H "api-key: $TRANSCRIBETUBE_API_KEY"

​
Response

200 OK — array of projects (one page): 
[
  {
    "id": "f3c1e7a0-2b48-4a91-8a30-9b1c2d3e4f50",
    "name": "Rick Astley - Never Gonna Give You Up",
    "youtubeId": "dQw4w9WgXcQ",
    "state": "done",
    "createdAt": "2026-01-15T14:30:00.000Z"
  },
  {
    "id": "a812b3c4-5d6e-7f8a-9b0c-1d2e3f4a5b60",
    "name": "Some other video",
    "youtubeId": "abc123XYZ_w",
    "state": "transcription",
    "createdAt": "2026-01-15T14:25:00.000Z"
  }
]
FieldTypeDescription
idstring (UUID)Project ID, used in GET /api/detail/{id}.
namestringVideo title from YouTube at submission time.
youtubeIdstringThe YouTube video ID.
stateenumupload | transcription | done | error. See Lifecycle.
createdAtstring (ISO 8601)When the project was created.

​
Pagination

There is no total count or hasMore field. To detect the last page, request until you receive an empty array. Pages are 1-indexed. 
let page = 1;
while (true) {
  const res = await fetch(`https://api.transcribetube.com/api/list?page=${page}`, {
    headers: { "api-key": apiKey },
  });
  const batch = await res.json();
  if (batch.length === 0) break;
  process(batch);
  page++;
}

​
Errors

StatusWhen
400page < 1 or not a number.
401Missing or invalid api-key header.

Authorizations

​
api-key
string
header
required

Query Parameters

​
page
integer
default:1

Page number for pagination

Response

One page of projects (max 100)

​
id
string<uuid>
​
name
string
Example:

"Rick Astley - Never Gonna Give You Up"

​
youtubeId
string
Example:

"dQw4w9WgXcQ"

​
state
enum<string>
Available options:
upload,
transcription,
done,
error
​
createdAt
string<date-time>