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.
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.