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 |
video_id |
string |
ID of the video received 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 |
check_url |
string |
direct URL to search engine results
you can use it to make sure that we provided accurate results |
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 |
spell |
object |
autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection |
refinement_chips |
object |
search refinement chips
equals null |
item_types |
array |
types of search results in SERP
contains types of search results (items) found in SERP.
possible item:
youtube_comment |
title |
string |
title of the video |
comments_count |
integer |
number of comments on the video |
items_count |
integer |
the number of results returned in the items array |
items |
array |
elements of search results found in SERP |
type |
string |
type of element = ‘youtube_comment’ |
rank_group |
integer |
group rank in SERP
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group |
rank_absolute |
integer |
absolute rank in SERP for the target domain
absolute position among all the elements in SERP |
author_name |
string |
name of the author of the comment |
author_thumbnail |
string |
the URL of the page where the author’s channel logo is hosted |
author_url |
string |
URL of the author’s channel |
text |
string |
text of the comment |
publication_date |
string |
displayed publication date |
timestamp |
string |
date and time when the result was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2022-11-15 12:57:46 +00:00
|
likes_count |
integer |
number of likes on the comment |
reply_count |
integer |
number of replies on the comment |