OnPage Page Screenshot

Name: OnPage Page Screenshot
Author: DataForSEO

dataforseo/v3/on_page/page_screenshot

Capture a full high-quality screenshot of any webpage.. Supports desktop, mobile, and tablet viewports.

Use in agent Get API key

Base price: $0.001 / run
Execution: sync
Model type: api
Input fields: 11

Try the model

Playground

Open playground

Input

Url(string)

page url required field absolute URL of the page to capture a screenshot of example: https://dataforseo.com/apis

Switch Pool(boolean)

switch proxy pool optional field if true, additional proxy pools will be used to obtain the requested data

Browser Preset(string)

preset for browser screen parameters optional field possible values: desktop, mobile, tablet desktop: 1920x1080, scale 1 mobile: 390x844, scale 3 tablet: 1024x1366, scale 2

Accept Language(string)

language header for accessing the website optional field all locale formats are supported (xx, xx-XX, xxx-XX, etc.) Note: if you do not specify this parameter, some websites may deny access

Ip Pool For Scan(string)

proxy pool location optional field possible values: us, de

Custom User Agent(string)

custom user agent optional field custom user agent for crawling a website default value: Mozilla/5.0 (compatible; RSiteAuditor)

Browser Screen Width(integer)

browser screen width in pixels optional field minimum value: 240 maximum value: 9999 if set, browser_preset is ignored

Disable Cookie Popup(boolean)

disable the cookie popup optional field set to true to dismiss cookie consent dialogs default value: false

Full Page Screenshot(boolean)

take a screenshot of the full page optional field set to false to capture only the visible viewport default value: true

Browser Screen Height(integer)

browser screen height in pixels optional field minimum value: 240 maximum value: 9999 if set, browser_preset is ignored

Browser Screen Scale Factor(number)

browser screen scale factor optional field minimum value: 0.5 maximum value: 3 if set, browser_preset is ignored

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Specifications

Pricing

Base price: $0.001 / run

Context & modalities

Supported modes: sync
Input: Schema-defined
Output: api

Capabilities

Chat: Not supported
Vision: Not supported
Reasoning: Not supported
Structured output: Not supported
Function calling: Not supported
Audio input: Not supported

Access

Provider: DataForSEO
Model ID: dataforseo/v3/on_page/page_screenshot
Execution: sync
API: Unified Run API
Endpoint: /v1/run

API README

OnPage Page Screenshot

Run the v3 on page page screenshot API operation through SandBase with required url input. Capture a full high-quality screenshot of any webpage. Returns a URL to the rendered PNG image. Supports desktop, mobile, and tablet viewports.

What it does

This API operation is provided by DataForSEO through SandBase.

Common use cases

Use it for v3 on page page screenshot workflows, automation, and structured application integrations.

Input parameters

Parameter	Required	Type	Description
`url`	Yes	`string`	page url required field absolute URL of the page to capture a screenshot of example: https://dataforseo.com/apis
`switch_pool`	No	`boolean`	switch proxy pool optional field if true, additional proxy pools will be used to obtain the requested data
`browser_preset`	No	`string`	preset for browser screen parameters optional field possible values: desktop, mobile, tablet desktop: 1920x1080, scale 1 mobile: 390x844, scale 3 tablet: 1024x1366, scale 2
`accept_language`	No	`string`	language header for accessing the website optional field all locale formats are supported (xx, xx-XX, xxx-XX, etc.) Note: if you do not specify this parameter, some websites may deny access
`ip_pool_for_scan`	No	`string`	proxy pool location optional field possible values: us, de
`custom_user_agent`	No	`string`	custom user agent optional field custom user agent for crawling a website default value: Mozilla/5.0 (compatible; RSiteAuditor)
`browser_screen_width`	No	`integer`	browser screen width in pixels optional field minimum value: 240 maximum value: 9999 if set, browser_preset is ignored
`disable_cookie_popup`	No	`boolean`	disable the cookie popup optional field set to true to dismiss cookie consent dialogs default value: false
`full_page_screenshot`	No	`boolean`	take a screenshot of the full page optional field set to false to capture only the visible viewport default value: true
`browser_screen_height`	No	`integer`	browser screen height in pixels optional field minimum value: 240 maximum value: 9999 if set, browser_preset is ignored
`browser_screen_scale_factor`	No	`number`	browser screen scale factor optional field minimum value: 0.5 maximum value: 3 if set, browser_preset is ignored

Request example

{
  "model": "dataforseo/v3/on_page/page_screenshot",
  "url": "example"
}

Response

The response contains the provider result for this operation. See the schema above for the documented response fields.

Limits and notes

Validate URLs, identifiers, and platform-specific values before sending a request. Results and availability depend on the upstream provider.

Pricing

Pricing follows the configured SandBase model card and provider-reported settlement where applicable.

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API

Endpoint

https://api.sandbase.ai/v1/run

Model ID

dataforseo/v3/on_page/page_screenshot

# Preserve Unicode and shell metacharacters in the request body.
result=$(printf '%s' 'ewogICJtb2RlbCI6ICJkYXRhZm9yc2VvL3YzL29uX3BhZ2UvcGFnZV9zY3JlZW5zaG90Igp9' \
  | base64 --decode \
  | curl --fail-with-body --silent \
      -X POST "https://api.sandbase.ai/v1/run" \
      -H "Authorization: Bearer $SANDBASE_API_KEY" \
      -H "Content-Type: application/json" \
      --data-binary @-)
printf '%s\n' "$result"

Choose your model

Compare models

All language models

Model	Context	Input / 1M	Output / 1M	Released
OnPage Page ScreenshotThis model `DataForSEO`	—	—	—	Jan 1, 2024
OnPage Content Parsing `DataForSEO`	—	—	—	Jan 1, 2024
OnPage Duplicate Tags `DataForSEO`	—	—	—	Jan 1, 2024
OnPage Instant Pages `DataForSEO`	—	—	—	Jan 1, 2024
OnPage Keyword Density `DataForSEO`	—	—	—	Jan 1, 2024
OnPage Lighthouse `DataForSEO`	—	—	—	Jan 1, 2024