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 |
contains the same parameters that you specified in the POST request |
result |
array |
array of results |
desktop |
object |
results for desktop |
location_code |
integer |
location code in a POST array
if there is no data, then the value is null |
language_code |
string |
language code in a POST array
if there is no data, then the value is null |
bid |
float |
the maximum custom bid
the bid you have specified when setting the task
represents the price you are willing to pay for an ad
the higher value you have specified, the higher positions and price you receive in response
learn more in this help center article |
keyword |
string |
keyword in a POST array |
match |
string |
keywords match-type
can take the following values: exact, broad, phrase |
ad_position_min |
float |
the minimum ad position
represents the minimum position of the advertisement
if there is no data, then the value is null |
ad_position_max |
float |
the maximum ad position
represents the maximum position of the advertisement
if there is no data, then the value is null |
ad_position_average |
float |
the average ad position
represents the average position of the advertisement
if there is no data, then the value is null |
cpc_min |
float |
the minimum value of cost-per-click
represents the minimum cost-per-click (USD) historically paid for the keyword
if there is no data, then the value is null |
cpc_max |
float |
the maximum value of cost-per-click
represents the maximum cost-per-click (USD) historically paid for the keyword
if there is no data, then the value is null |
cpc_average |
float |
the average value of cost-per-click
represents the average cost-per-click (USD) historically paid for the keyword
if there is no data, then the value is null |
daily_impressions_min |
float |
the minimum value of daily impressions
represents the minimum number of daily impressions of the advertisement
if there is no data, then the value is null
learn more about impressions in this help center article |
daily_impressions_max |
float |
the maximum value of daily impressions
represents the maximum number of daily impressions of the advertisement
if there is no data, then the value is null
learn more about impressions in this help center article |
daily_impressions_average |
float |
the average value of daily impressions
represents the average number number of daily impressions of the advertisement
if there is no data, then the value is null
learn more about impressions in this help center article |
daily_clicks_min |
float |
the minimum value of daily clicks
represents the minimum number of daily clicks on the advertisement
if there is no data, then the value is null |
daily_clicks_max |
float |
the maximum value of daily clicks
represents the maximum number of daily clicks on the advertisement
if there is no data, then the value is null |
daily_clicks_average |
float |
the average value of daily clicks
represents the average number of daily clicks on the advertisement
if there is no data, then the value is null |
daily_cost_min |
float |
the minimum daily charge value
represents the minimum daily charge for the advertisement (USD)
if there is no data, then the value is null |
daily_cost_max |
float |
the maximum daily charge value
represents the maximum daily charge for the advertisement (USD)
if there is no data, then the value is null |
daily_cost_average |
float |
the average daily charge value
represents the average daily charge for the advertisement (USD)
if there is no data, then the value is null |
mobile |
object |
results for mobile |
location_code |
integer |
location code in a POST array
if there is no data, then the value is null |
language_code |
string |
language code in a POST array
if there is no data, then the value is null |
bid |
float |
the maximum custom bid
the bid you have specified when setting the task
represents the price you are willing to pay for an ad
the higher value you have specified, the higher positions and price you receive in response
learn more in this help center article |
keyword |
string |
keyword
keyword is returned with decoded %## (plus symbol ‘+’ will be decoded to a space character) |
match |
string |
keywords match-type
can take the following values: exact, broad, phrase |
ad_position_min |
float |
the minimum ad position
represents the minimum position of the advertisement
if there is no data, then the value is null |
ad_position_max |
float |
the maximum ad position
represents the maximum position of the advertisement
if there is no data, then the value is null |
ad_position_average |
float |
the average ad position
represents the average position of the advertisement
if there is no data, then the value is null |
cpc_min |
float |
the minimum value of cost-per-click
represents the minimum cost-per-click (USD) historically paid for the keyword
if there is no data, then the value is null |
cpc_max |
float |
the maximum value of cost-per-click
represents the maximum cost-per-click (USD) historically paid for the keyword
if there is no data, then the value is null |
cpc_average |
float |
the average value of cost-per-click
represents the average cost-per-click (USD) historically paid for the keyword
if there is no data, then the value is null |
daily_impressions_min |
float |
the minimum value of daily impressions
represents the minimum number of daily impressions of the advertisement
if there is no data, then the value is null
learn more about impressions in this help center article |
daily_impressions_max |
float |
the maximum value of daily impressions
represents the maximum number of daily impressions of the advertisement
if there is no data, then the value is null
learn more about impressions in this help center article |
daily_impressions_average |
float |
the average value of daily impressions
represents the average number number of daily impressions of the advertisement
if there is no data, then the value is null
learn more about impressions in this help center article |
daily_clicks_min |
float |
the minimum value of daily clicks
represents the minimum number of daily clicks on the advertisement
if there is no data, then the value is null |
daily_clicks_max |
float |
the maximum value of daily clicks
represents the maximum number of daily clicks on the advertisement
if there is no data, then the value is null |
daily_clicks_average |
float |
the average value of daily clicks
represents the average number of daily clicks on the advertisement
if there is no data, then the value is null |
daily_cost_min |
float |
the minimum daily charge value
represents the minimum daily charge for the advertisement (USD)
if there is no data, then the value is null |
daily_cost_max |
float |
the maximum daily charge value
represents the maximum daily charge for the advertisement (USD)
if there is no data, then the value is null |
daily_cost_average |
float |
the average daily charge value
represents the average daily charge for the advertisement (USD)
if there is no data, then the value is null |
tablet |
object |
results for tablet |
location_code |
integer |
location code in a POST array
if there is no data, then the value is null |
language_code |
string |
language code in a POST array
if there is no data, then the value is null |
bid |
float |
the maximum custom bid
the bid you have specified when setting the task
represents the price you are willing to pay for an ad
the higher value you have specified, the higher positions and price you receive in response
you can learn more in this help center article |
keyword |
string |
keyword
keyword is returned with decoded %## (plus symbol ‘+’ will be decoded to a space character) |
match |
string |
keywords match-type
can take the following values: exact, broad, phrase |
ad_position_min |
float |
the minimum ad position
represents the minimum position of the advertisement
if there is no data, then the value is null |
ad_position_max |
float |
the maximum ad position
represents the maximum position of the advertisement
if there is no data, then the value is null |
ad_position_average |
float |
the average ad position
represents the average position of the advertisement
if there is no data, then the value is null |
cpc_min |
float |
the minimum value of cost-per-click
represents the minimum cost-per-click (USD) historically paid for the keyword
if there is no data, then the value is null |
cpc_max |
float |
the maximum value of cost-per-click
represents the maximum cost-per-click (USD) historically paid for the keyword
if there is no data, then the value is null |
cpc_average |
float |
the average value of cost-per-click
represents the average cost-per-click (USD) historically paid for the keyword
if there is no data, then the value is null |
daily_impressions_min |
float |
the minimum value of daily impressions
represents the minimum number of daily impressions of the advertisement
if there is no data, then the value is null
learn more about impressions in this help center article |
daily_impressions_max |
float |
the maximum value of daily impressions
represents the maximum number of daily impressions of the advertisement
if there is no data, then the value is null
learn more about impressions in this help center article |
daily_impressions_average |
float |
the average value of daily impressions
represents the average number number of daily impressions of the advertisement
if there is no data, then the value is null
learn more about impressions in this help center article |
daily_clicks_min |
float |
the minimum value of daily clicks
represents the minimum number of daily clicks on the advertisement
if there is no data, then the value is null |
daily_clicks_max |
float |
the maximum value of daily clicks
represents the maximum number of daily clicks on the advertisement
if there is no data, then the value is null |
daily_clicks_average |
float |
the average value of daily clicks
represents the average number of daily clicks on the advertisement
if there is no data, then the value is null |
daily_cost_min |
float |
the minimum daily charge value
represents the minimum daily charge for the advertisement (USD)
if there is no data, then the value is null |
daily_cost_max |
float |
the maximum daily charge value
represents the maximum daily charge for the advertisement (USD)
if there is no data, then the value is null |
daily_cost_average |
float |
the average daily charge value
represents the average daily charge for the advertisement (USD)
if there is no data, then the value is null |