Step 1: Make Your First API Call Let’s retrieve all recordings in your workspace using a GET request :
curl -X GET "https://{your-subdomain}.neetorecord.com/api/external/v2/recordings" \ -H 'X-Api-Key: your-api-key' \ -H 'Content-Type: application/json'
Replace your-subdomain with your actual workspace subdomain and
your-api-key with your generated API key.
Step 2: Understanding the Response A successful response will look like this JSON format:
{ "recordings" : [ { "id" : "recording-123" , "title" : "Product Demo" , "default_title" : "Recording 2025-01-15" , "duration" : 120.5 , "view_count" : 42 , "is_uploaded" : true , "requested" : false , "summary" : "A walkthrough of the new product features." , "public_link_id" : "abc123" , "transcoded_url" : "https://cdn.neetorecord.com/..." , "thumbnail_url" : "https://cdn.neetorecord.com/..." , "user_name" : "Jane Smith" , "tags" : [ { "id" : "tag-1" , "name" : "Demo" , "style" : "blue" } ], "folder_name" : "Product Demos" , "folder_id" : "folder-1" , "created_at" : "2025-01-15T10:30:00Z" , "updated_at" : "2025-01-15T10:30:00Z" , "uploaded_at" : "2025-01-15T10:31:00Z" } ], "pagination" : { "total_records" : 1 , "total_pages" : 1 , "current_page_number" : 1 , "page_size" : 30 } }
Next Steps Now that you’ve made your first API call, you can:
Explore API reference Browse all available endpoints and their detailed documentation.
Pagination Understand how to paginate through API responses efficiently.
HTTP response codes Learn what different response codes mean and how to handle them.
