Get ‘Ads Traffic By Keywords’ Results by id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Get ‘Ads Traffic By Keywords’ Results by id
Retrieves a queued Google Ads traffic forecast by id: projected impressions, clicks, cost and average position for the bid you specified. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. Unlike the volume endpoints this is a projection, not a measurement - the numbers move with bid and match.
Pricing reference
- Metering: Reported response cost.
- Reference request estimate: USD 0.012.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.
- Type: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResponseInfo200
- Type: number | null Format: doublecost
total tasks cost, USD
- Type: integer | nullstatus
_code general status code you can find the full list of the response codes here
- Type: string | nullstatus
_message general informational message you can find the full list of general informational messages here
- Type: array (object | null)[] | nulltasks
array of tasks
- Type: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetTaskInfo
- costType: number | null Format: double
total tasks cost, USD
- dataType: object | null
contains the same parameters that you specified in the POST request
- propertyType: object | null
Name
- idType: string | null
task identifier unique task identifier in our system in the UUID format
- pathType: array (string | null)[] | null
URL path
- resultType: array (object | null)[] | null
array of results
- averageType: number | null Format: double
_cpc the average cost-per-click value
represents the cost-per-click (USD) estimated for a keyword based on the specified time period and historical data;
if there is no data, then the value is_nulln - bidType: number | null
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 metrics and cost you receive in response
learn more in this help center article - clicksType: number | null
number of clicks on an ad
number of clicks an ad is projected to get within the specified time period
if there is no data, then the value is_nulln - costType: number | null
charge for an ad
amount that will be charged for running an ad within the specified time period
if there is no data, then the value is_nulln - ctrType: number | null Format: double
projected clickthrough rate (CTR) of the advertisement
number of clicks an ad is projected to receive divided by the number of ad impressions;
Note: parameter deprecated, the value is alwaysnull - dateType: string | null
_interval forecasting date interval in a POST array
- impressionsType: integer | null
projected number of ad impressions
number of impressions an ad is projected to get within the specified time period
Note: parameter deprecated, the value is always_nulln - keywordType: string | null
keyword in a POST array
metrics are provided for all the keywords specified in the POST array - languageType: string | null
_code language code in a POST array
if there is no data, then the value is_nulln - locationType: integer | null
_code location code in a POST array
if there is no data, then the value is_nulln - matchType: string | null
keywords match-type
can take the following values:exact,broad,phrase - searchType: boolean | null
_partners include Google search partners
the value is alwaysfalse
- resultType: integer | null Format: int64
_count number of elements in the result array
- statusType: integer | null
_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
- statusType: string | null
_message informational message of the task you can find the full list of general informational messages here
- timeType: string | null
execution time, seconds
- Type: integer | null Format: int64tasks
_count the number of tasks in the tasks array
- Type: integer | null Format: int64tasks
_error the number of tasks in the tasks array returned with an error
- Type: string | nulltime
total execution time, seconds
- Type: string | nullversion
the current version of the API
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 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
Error response; upstream passthrough responses may use provider formats
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"location_code": null,
"language_code": null,
"date_interval": null,
"search_partners": null,
"bid": null,
"match": null,
"impressions": null,
"ctr": null,
"average_cpc": null,
"cost": null,
"clicks": null
}
]
}
]
}