DataForSEO Labs Status
By calling this endpoint, you will find out when the DataForSEO Labs data was last updated. The API response will provide separate update dates for the Google, Bing, and Amazon endpoints of DataForSEO Labs API.
By calling this endpoint, you will find out when the DataForSEO Labs data was last updated. The API response will provide separate update dates for the Google, Bing, and Amazon endpoints of DataForSEO Labs API.
Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access
<?php // You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip require('RestClient.php'); $api_url = 'https://api.dataforseo.com/'; try { // Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access $client = new RestClient($api_url, null, 'login', 'password'); } catch (RestClientException $e) { echo "n"; print "HTTP code: {$e->getHttpCode()}n"; print "Error code: {$e->getCode()}n"; print "Message: {$e->getMessage()}n"; print $e->getTraceAsString(); echo "n"; exit(); } try { // using this method you can get the Google Ads status // GET /v3/dataforseo_labs/status $result = $client->get('/v3/dataforseo_labs/status'); print_r($result); // do something with result } catch (RestClientException $e) { echo "n"; print "HTTP code: {$e->getHttpCode()}n"; print "Error code: {$e->getCode()}n"; print "Message: {$e->getMessage()}n"; print $e->getTraceAsString(); echo "n"; } $client = null; ?>
The above command returns JSON structured like this:
{ "version": "0.1.20220428", "status_code": 20000, "status_message": "Ok.", "time": "0.0938 sec.", "cost": 0, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "05231003-2806-0448-0000-46d401ea6c2f", "status_code": 20000, "status_message": "Ok.", "time": "0.0271 sec.", "cost": 0, "result_count": 1, "path": [ "v3", "dataforseo_labs", "status" ], "data": { "api": "dataforseo_labs", "function": "status" }, "result": [ { "google": { "date_update": "2022-05-16" }, "bing": { "date_update": "2022-05-16" }, "amazon": { "date_update": "2022-05-23" } } ] } ] }
As a response of the API server, you will receive JSON-encoded data containing a tasks
array with the information specific to the set tasks.
Field name | Type | Description |
---|---|---|
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 Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions |
status_message |
string | general informational message you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | total tasks cost, USD |
tasks_count |
integer | the number of tasks in the tasks array |
tasks_error |
integer | the number of tasks in the tasks array returned with an error |
tasks |
array | array of tasks |
id |
string | task identifier unique task identifier in our system in the UUID format |
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 response codes here |
status_message |
string | informational message of the task you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | cost of the task, USD |
result_count |
integer | number of elements in the result array |
path |
array | URL path |
data |
object | the data specified in the API call |
result |
array | array of results |
google |
object | update information for the Google endpoints |
date_update |
string | update date of the Google endpoints indicates the last date when the Google endpoints of DataForSEO Labs API were updated; example: 2022-05-16 |
bing |
object | update information for the Bing endpoints |
date_update |
string | update date of the Bing endpoints indicates the last date when the Bing endpoints of DataForSEO Labs API were updated; example: 2022-05-16 |
amazon |
object | update information for the Amazon endpoints |
date_update |
string | update date of the Amazon endpoints indicates the last date when the Amazon endpoints of DataForSEO Labs API were updated; example: 2022-05-23 |