Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access
# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access \login="login"password="password"cred="$(printf ${login}:${password} | base64)"id="02261816-2027-0066-0000-c27d02864073"curl --location --request GET "https://api.dataforseo.com/v3/serp/google/images/task_get/html/${id}" \--header "Authorization: Basic ${cred}" \--header "Content-Type: application/json" \--data-raw ''# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access \ login="login" password="password" cred="$(printf ${login}:${password} | base64)" id="02261816-2027-0066-0000-c27d02864073" curl --location --request GET "https://api.dataforseo.com/v3/serp/google/images/task_get/html/${id}" \ --header "Authorization: Basic ${cred}" \ --header "Content-Type: application/json" \ --data-raw ''# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access \ login="login" password="password" cred="$(printf ${login}:${password} | base64)" id="02261816-2027-0066-0000-c27d02864073" curl --location --request GET "https://api.dataforseo.com/v3/serp/google/images/task_get/html/${id}" \ --header "Authorization: Basic ${cred}" \ --header "Content-Type: application/json" \ --data-raw ''
The above command returns JSON structured like this:
{"version": "0.1.20200129","status_code": 20000,"status_message": "Ok.","time": "0.3212 sec.","cost": 0,"tasks_count": 1,"tasks_error": 0,"tasks": [{"id": "11151505-0696-0066-0000-340aec686f0d","status_code": 20000,"status_message": "Ok.","time": "0.0684 sec.","cost": 0.00,"result_count": 1,"path": ["v3","serp","google","images","task_get","html","11151505-0696-0066-0000-340aec686f0d"],"data": {"api": "serp","function": "task_get","se": "google","se_type": "images","language_name": "English","location_code": 2840,"keyword": "flight ticket new york san francisco","tag": "tag1","device": "desktop","os": "windows"},"result": [{"keyword": "flight ticket new york san francisco","type": "images","se_domain": "google.com","location_code": 2840,"language_code": "en","datetime": "2019-11-15 13:05:36 +0000","items_count": 1,"items": [{"page": 1,"date": "2019-11-15 13:05:36 +0000","html": "<!doctype html><html><head></head></body></html>"}]}]}]}{ "version": "0.1.20200129", "status_code": 20000, "status_message": "Ok.", "time": "0.3212 sec.", "cost": 0, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "11151505-0696-0066-0000-340aec686f0d", "status_code": 20000, "status_message": "Ok.", "time": "0.0684 sec.", "cost": 0.00, "result_count": 1, "path": [ "v3", "serp", "google", "images", "task_get", "html", "11151505-0696-0066-0000-340aec686f0d" ], "data": { "api": "serp", "function": "task_get", "se": "google", "se_type": "images", "language_name": "English", "location_code": 2840, "keyword": "flight ticket new york san francisco", "tag": "tag1", "device": "desktop", "os": "windows" }, "result": [ { "keyword": "flight ticket new york san francisco", "type": "images", "se_domain": "google.com", "location_code": 2840, "language_code": "en", "datetime": "2019-11-15 13:05:36 +0000", "items_count": 1, "items": [ { "page": 1, "date": "2019-11-15 13:05:36 +0000", "html": "<!doctype html><html><head></head></body></html>" } ] } ] } ] }{ "version": "0.1.20200129", "status_code": 20000, "status_message": "Ok.", "time": "0.3212 sec.", "cost": 0, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "11151505-0696-0066-0000-340aec686f0d", "status_code": 20000, "status_message": "Ok.", "time": "0.0684 sec.", "cost": 0.00, "result_count": 1, "path": [ "v3", "serp", "google", "images", "task_get", "html", "11151505-0696-0066-0000-340aec686f0d" ], "data": { "api": "serp", "function": "task_get", "se": "google", "se_type": "images", "language_name": "English", "location_code": 2840, "keyword": "flight ticket new york san francisco", "tag": "tag1", "device": "desktop", "os": "windows" }, "result": [ { "keyword": "flight ticket new york san francisco", "type": "images", "se_domain": "google.com", "location_code": 2840, "language_code": "en", "datetime": "2019-11-15 13:05:36 +0000", "items_count": 1, "items": [ { "page": 1, "date": "2019-11-15 13:05:36 +0000", "html": "<!doctype html><html><head></head></body></html>" } ] } ] } ] }
Description of the fields for sending a request:
Field name | Type | Description | |
---|---|---|---|
id |
string | task identifier unique task identifier in our system in the UUID format you will be able to use it within 7 days to request the results of the task at any time |
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.
Description of the fields in the results array:
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 the 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 | contains the same parameters that you specified in the POST request | |
result |
array | array of results | |
keyword |
string | keyword received in a POST array keyword is returned with decoded %## (plus symbol ‘+’ will be decoded to a space character) |
|
type |
string | search engine type in a POST array | |
se_domain |
string | search engine domain in a POST array | |
location_code |
integer | location code in a POST array | |
language_code |
string | language code in a POST array | |
datetime |
string | date and time when the result was received in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
|
items_count |
integer | the number of results returned in the items array |
|
items |
array | elements of search results found in SERP | |
page |
integer | serial number of the returned HTML page | |
date |
string | date and time when the HTML page was scanned in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
|
html |
string | HTML page |