Skip to main content
POST
SERP API Page Screenshot
Returns a rendered screenshot of a search result page on Google. Returns keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count and items. Wrapped in DataForSEO’s envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.

Example

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. The commands per client, and what each call costs, are on aisa.one/mcp.
Set this endpoint up in your agent →

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
task_id
string
required

task identifier required field unique identifier of the associated task in the UUID format you will be able to use it within 7 days to request the results of the task at any time

browser_preset
string

browser resolution preset optional field browser preset associated with a certain device type can take the following values: desktop, tablet, mobile Note: by default, browser preset corresponds to the device type specified in the POST request

browser_screen_width
integer

width of the browser resolution optional field can be specified in the following range: 240-9999 default value for desktop: 1920 default value for mobile: 390 default value for table: 1024

browser_screen_height
integer

height of the browser resolution optional field can be specified in the following range: 240-9999 default value for desktop: 1080 default value for mobile: 844 default value for table: 1366

browser_screen_scale_factor
number

browser scale factor optional field can be specified in the following range: 0.5-3 default value for desktop: 1 default value for mobile: 3 default value for table: 2

page
integer

number of SERP pages optional field if depth in the corresponding Task POST request exceeds 10 results (or 1 SERP page), specify the number of SERP pages to screenshot; default value: 1

Response

Successful operation

version
string

The current version of the API

status_code
integer

general status code you can find the full list of the response codes here

status_message
string

general informational message you can find the full list of general informational messages here

time
string

total execution time, seconds

cost
number

total tasks cost, USD

tasks
string[]

Array of tasks

tasks[].id
string

task identifier unique task identifier in our system in the UUID format

tasks[].status_code
integer

status code of the task generated by DataForSEO, can be within the following range: 10000-60000 you can find the full list of the response codes here

tasks[].status_message
string

informational message of the task you can find the full list of general informational messages here

tasks[].result_count
integer

Number of elements in the result array

tasks[].path
string[]

URL path

tasks[].data
object

contains the same parameters that you specified in the POST request

tasks[].result
string[]

Array of results

tasks[].result[].items_count
integer

Number of items in the results array

tasks[].result[].items
string[]

Items array

tasks[].result[].items[].image
string

screenshot of the requested page URL of the page screenshot on the DataForSEO storage note: the page screenshot saved on the DataForSEO storage only remains accessible for one day after making the request