Skip to main content
GET
OnPage API Summary
The state and headline metrics of one crawl, by id. Returns crawl_progress, crawl_status, crawl_gateway_address, crawl_stop_reason, domain_info and page_metrics. Measured at 3.1 KB. Wrapped in DataForSEO’s envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. This is also the way to know a crawl has finished - poll it until crawl_progress is finished before reading any other endpoint here, or you will read partial results that look like real ones. 💰 Free upstream: querying a finished crawl costs nothing, only the crawl itself does. This family is the cheapest in the provider.

Example

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

DataForSEO task ID.

Response

Successful response

id
string

task identifier required field you can get this ID in the response of the Task POST endpoint example: “07131248-1535-0216-1000-17384017ad04”