Download Past Transcripts via API (v2)

Want to download transcripts or summaries from past Demodesk recordings? This guide walks you through how to do it using the Demodesk API, step-by-step.

Need the full technical details? Check the API Reference for all parameters and response schemas.

Before you start

You'll need two things:

What	Where to get it
API key	Demodesk > Settings > Integrations > Other
The right permissions	Your API key inherits the permissions of the user who created it

Tip on permissions: If you want to export recordings from your whole company, make sure the API key was created by an admin who has access to all recordings (the user is either added to all groups in the company or is added to a group that has access to all recordings in the company)

Please note that recordings set to "only me" by a user cannot be accessed by anyone else, even admins.

How it works

Step	What you do
1	Get a list of your recordings
2	Go through all pages of results
3	Download the transcripts
4	(Optional) Download the summaries

Step 1: Get your recordings

Call this endpoint to list recordings you have access to:

GET https://demodesk.com/api/v2/recordings api-key: <YOUR_API_KEY>

Recommended filters to add:

Filter	What it does
`filter[postprocessing_status_eq]=done`	Only returns recordings that are fully processed (transcript + summary ready)
`filter[status_eq]=ready`	Only returns recordings that are available
`filter[created_at_gteq]=<date>`	Useful if you want to export from a specific date onwards
`filter[demo_user_id_eq]=<USER_ID>`	Use this to pull recordings for one specific user
`limit=100`	Returns up to 100 results per page

Example with all filters:

GET https://demodesk.com/api/v2/recordings?filter[postprocessing_status_eq]=done&filter[status_eq]=ready&limit=100 api-key: <YOUR_API_KEY>

Step 2: Page through all results

The API returns results in pages. Each response tells you:

Is there a next page? → check meta.hasNext
How to get the next page? → use the value from meta.nextCursor and add cursor=<value> to your next call

Keep repeating until meta.hasNext is false.

From each recording, save the recordingToken. You'll need it in the next steps.

Step 3: Download transcripts

You have two options:

Option A: Batch download (recommended)

Download up to 100 transcripts at once:

POST https://demodesk.com/api/v2/transcripts/batch api-key: <YOUR_API_KEY> Content-Type: application/json  {   "recordingTokens": ["<TOKEN_1>", "<TOKEN_2>"],   "format": "plaintext" }

Option B: Single transcript

Download one transcript at a time:

GET https://demodesk.com/api/v2/recordings/<TOKEN>/transcript?format=plaintext api-key: <YOUR_API_KEY>

What the API might return:

Response	Meaning
`200`	Transcript is ready
`202`	Still processing. Try again later
`204`	Transcript exists but is empty or too short
`404`	Not found

Step 4: Download summaries (optional)

GET https://demodesk.com/api/v2/recordings/<TOKEN>/summaries api-key: <YOUR_API_KEY>

Each summary includes the content, HTML version, and some metadata like the prompt name and timestamps.

Rate limits

Limit	Value
General (all endpoints)	120 requests per minute
Listing recordings only	20 requests per minute

If you hit a limit, the API returns a 429 response, sometimes with a Retry-After header that tells you how many seconds to wait.

Troubleshooting

I only see my own recordings

Your API key only sees what its creator can see. Use an admin key for company-wide access.

Some recordings are missing

Recordings set to "only me" are private. No one else (other than the host) can access them.

Transcripts aren't showing up

They may still be processing. Filter by postprocessing_status_eq=done to avoid this.

API Reference

Automatically Fetch Transcripts from Demodesk Using n8n

Automatically Fetch Transcripts from Demodesk Using Make

Download Past Transcripts via API (Coaching & AI Users)

Automatically Fetch Transcripts from Demodesk Using Zoho Flow