DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
On-Page Tasks Ready
Lists the crawls that have finished. Returns null with status_code 20000 and Ok. when none are - an empty queue, not an error. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. ⚠️ Rarely the tool you want: a caller holds the id its own post_dataforseo_on_page_submit returned, and get_dataforseo_on_page_summary answers whether that particular crawl is done.
- 類型: object200
Successful response
- 類型: numbercost
total tasks cost, USD
- 類型: integerstatus
_code general status code you can find the full list of the response codes here
- 類型: stringstatus
_message general informational message you can find the full list of general informational messages here
- 類型: array string[]tasks
array of tasks
- 類型: integertasks
_count the number of tasks in the tasks array
- 類型: integertasks
_error the number of tasks in the tasks array returned with an error
- 類型: numbertasks
.cost cost of the task, USD
- 類型: array string[]tasks
.data contains the parameters passed in the request’s URL
- 類型: stringtasks
.id task identifier unique task identifier in our system in the UUID format
- 類型: array string[]tasks
.path URL path
- 類型: array string[]tasks
.result array of results
- 類型: integertasks
.result _count number of elements in the result array
- 類型: stringtasks
.result .date _posted date when the task was posted (in the UTC format)
- 類型: stringtasks
.result .id task identifier of the completed task unique task identifier in our system in the UUID format
- 類型: stringtasks
.result .tag user-defined task identifier
- 類型: stringtasks
.result .target target website specified when setting a task
- 類型: integertasks
.status _code 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
- 類型: stringtasks
.status _message informational message of the task you can find the full list of general informational messages here
- 類型: stringtasks
.time execution time, seconds
- 類型: stringtime
execution time, seconds
- 類型: stringversion
the current version of the API
application/json - 400
Bad request
- 401
Unauthorized
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
Rate limit exceeded
- 500
Internal server error
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/tasks_ready \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks.id": "string",
"tasks.status_code": 1,
"tasks.status_message": "string",
"tasks.time": "string",
"tasks.cost": 1,
"tasks.result_count": 1,
"tasks.path": [
"string"
],
"tasks.data": [
"string"
],
"tasks.result": [
"string"
],
"tasks.result.id": "string",
"tasks.result.target": "string",
"tasks.result.date_posted": "string",
"tasks.result.tag": "string"
}