---
title: "Capture a screenshot"
method: POST
path: "/v1/browser/screenshot"
---

# Capture a screenshot

`POST /v1/browser/screenshot`

## Request

- Base URL: `https://api.roveapi.com`
- URL: `https://api.roveapi.com/v1/browser/screenshot`
- Auth: HTTP bearer

## Request body

- object
  - `url` string, required
  - `selector` string
  - `full_page` boolean, required
  - `format` 'png' | 'jpeg', required
  - `quality` integer, required
  - `viewport` object
    - `width` integer, required
    - `height` integer, required

## Response `200`

Successful response

## Other responses

- `401`: RFC 7807 authentication problem
- `402`: RFC 7807 insufficient-credits: the balance does not cover this operation; carries the balance, the packs this key may buy and next_step (buy_credits or ask_owner)
- `409`: RFC 7807 state/control problem
- `410`: RFC 7807 expired or replayed admission problem

---

[API](https://skmtc.dev/roveapi/apis/rove-api.md) · [All operations](https://skmtc.dev/roveapi/apis/rove-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roveapi/apis/rove-api/revisions/0e5d69bde586?raw)
