get_screenshot

The get_screenshot method captures a screenshot of the current browser window and returns it as base64-encoded image data along with metadata. Unlike asking Agent.run() to take a screenshot and save it to disk, this method returns the screenshot data programmatically.

This method returns screenshot data directly in your code rather than saving it to disk. If you need screenshots saved automatically to your Downloads folder, use Agent.run() with a prompt like “take a screenshot of this page” instead.

Method Signature

async def get_screenshot(
    self,
    *,
    timeout: int | None = None,
) -> GetScreenshotResponse

Parameters

int | None

default:"None"

Maximum time in seconds to wait for the screenshot capture to complete. If None, uses the default system timeout.

timeout=30     # Wait up to 30 seconds
timeout=None   # Use default timeout

Return Value

Returns a GetScreenshotResponse object with the following structure:

str

required

The screenshot image encoded as a base64 string. This can be decoded and saved to a file, displayed, or processed programmatically.

str

required

A suggested filename for the screenshot, typically in a format like “Screenshot 2026-01-14 at 10.54.54 AM”.

str

required

The MIME type of the image format (e.g., “image/png”, “image/jpeg”).

str

required

ISO 8601 formatted timestamp indicating when the screenshot was captured.

Example

import asyncio
import base64

from narada import Agent, BrowserEnvironment

async def main():
    env = BrowserEnvironment()
    agent = Agent(environment=env)

    try:
        # Navigate to a page
        await agent.go_to_url(url="https://example.com")

        # Capture a screenshot
        response = await agent.get_screenshot()

        # Decode and save the screenshot
        image_data = base64.b64decode(response.base64_content)
        extension = response.mime_type.split('/')[1]  # "png" or "jpeg"
        filename = f"{response.name}.{extension}"

        with open(filename, "wb") as f:
            f.write(image_data)

        print(f"Screenshot saved as {filename}")
        print(f"Captured at: {response.timestamp}")
    finally:
        await env.close()

if __name__ == "__main__":
    asyncio.run(main())

Quickstart

API Endpoints

Python SDK

get_screenshot

Method Signature

Parameters

Return Value

Example

​Method Signature

​Parameters

​Return Value

​Example

Method Signature

Parameters

Return Value

Example