GET
/
api
/
v1
/
task
/
{task_id}
/
screenshots
import requests

API_KEY = 'your_api_key_here'
BASE_URL = 'https://api.browser-use.com/api/v1'
HEADERS = {'Authorization': f'Bearer {API_KEY}'}

task_id = 'task_1234567890abcdef'
response = requests.get(f'{BASE_URL}/task/{task_id}/screenshots', headers=HEADERS)
screenshots = response.json()
print(f"Found {len(screenshots['screenshots'])} screenshots")

# Download the first screenshot
if screenshots['screenshots']:
    screenshot_url = screenshots['screenshots'][0]
    img_response = requests.get(screenshot_url)
    with open('screenshot.png', 'wb') as f:
        f.write(img_response.content)

{
  "screenshots": [
    "https://media.browser-use.com/screenshots/task_1234567890abcdef/step_1.png",
    "https://media.browser-use.com/screenshots/task_1234567890abcdef/step_2.png",
    "https://media.browser-use.com/screenshots/task_1234567890abcdef/step_3.png"
  ]
}

Returns any screenshot URLs generated during task execution. Screenshots are automatically captured at key moments during the automation process.

​
task_id
string
required

ID of the task to retrieve screenshots for

​
screenshots
array

List of screenshot URLs generated during task execution

import requests

API_KEY = 'your_api_key_here'
BASE_URL = 'https://api.browser-use.com/api/v1'
HEADERS = {'Authorization': f'Bearer {API_KEY}'}

task_id = 'task_1234567890abcdef'
response = requests.get(f'{BASE_URL}/task/{task_id}/screenshots', headers=HEADERS)
screenshots = response.json()
print(f"Found {len(screenshots['screenshots'])} screenshots")

# Download the first screenshot
if screenshots['screenshots']:
    screenshot_url = screenshots['screenshots'][0]
    img_response = requests.get(screenshot_url)
    with open('screenshot.png', 'wb') as f:
        f.write(img_response.content)

{
  "screenshots": [
    "https://media.browser-use.com/screenshots/task_1234567890abcdef/step_1.png",
    "https://media.browser-use.com/screenshots/task_1234567890abcdef/step_2.png",
    "https://media.browser-use.com/screenshots/task_1234567890abcdef/step_3.png"
  ]
}

​
Screenshot Details

Screenshots are captured automatically during task execution:

  • Step-by-step captures: Screenshots taken at each major step
  • Error captures: Screenshots captured when errors occur
  • Final result: Screenshot of the final state when task completes
  • High resolution: Screenshots are captured at full browser resolution

​
File Format

  • All screenshots are saved in PNG format
  • Screenshots maintain the original browser viewport dimensions
  • File names include the task ID and step number for easy identification

​
Availability

  • Screenshots are available immediately after capture
  • Files are stored for 30 days after task completion
  • Screenshots can be disabled in task settings to reduce storage usage

Screenshots are automatically generated for most tasks unless specifically disabled. The number of screenshots depends on the task complexity and duration.