List Browser Session Downloads

List files the browser downloaded to S3 during the session.

Pass includeUrls=true to receive presigned download URLs (15 min expiry) inline. Files are stored at downloads/projects/{project_id}/sessions/{session_id}/ in the private bucket.

GET /browsers/{session_id}/downloads

List Browser Session Downloads

JavaScript

const options = {method: 'GET', headers: {'X-Browser-Use-API-Key': '<api-key>'}};

fetch('https://api.browser-use.com/api/v4/browsers/{session_id}/downloads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "files": [
    {
      "path": "<string>",
      "size": 123,
      "lastModified": "2023-11-07T05:31:56Z",
      "url": "<string>"
    }
  ],
  "nextCursor": "<string>",
  "hasMore": false
}

Authorizations

X-Browser-Use-API-Key · string · header · required

Path Parameters

session_id · string<uuid> · required

Query Parameters

limit · integer · default: 50

Required range: 1 <= x <= 100

cursor · string | null

includeUrls · boolean · default: false

Response

200

application/json

Successful Response

Paginated list of browser downloads with optional presigned URLs.

files · BrowserDownloadFile · object[] · required

List of files downloaded by the browser

Show child attributes

nextCursor · string | null

Cursor for the next page. Pass as the cursor query parameter to fetch the next page.

hasMore · boolean · default: false

Whether there are more files beyond this page.