Skip to main content
GET
/
browser
/
sessions
/
{id}
/
recording
Download Recording
curl --request GET \
  --url https://api.example.com/browser/sessions/{id}/recording

​
Overview

Returns the MP4 bytes of the most recent completed recording for the session. Call POST /browser/sessions/{id}/recording/stop first — in-progress recordings cannot be downloaded. Response Content-Type is video/mp4 with a Content-Disposition: attachment header.

​
Path Parameters

​
id
string
required
Browser session ID (UUID).

​
Example Request

curl -X GET "https://api.scrapengine.io/api/v1/browser/sessions/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7/recording" \
  -H "Authorization: Bearer $SCRAPENGINE_API_KEY" \
  -o session.mp4

​
Response

​
Success Response (200)

Binary MP4. Response headers:
  • Content-Type: video/mp4
  • Content-Disposition: attachment; filename="recording-<id>.mp4"
Save with -o session.mp4 in cURL, or read response.body as bytes.

​
Error Responses

StatusDescription
401Unauthorized — invalid or missing API key.
404Session not found, or no completed recording exists.
409Recording is still in progress — stop it first.