Get Keyword Data
This endpoint returns the SERP, search and your ranking data for the keywords specified in the request.
Request
(Required) This parameter specifies the ID of the campaign for which you want to return data.
Please refer to the Quick Start Guide to learn how to retrieve the IDs of your campaigns.
(Required) Comma-separated list of keyword phrases that you want to return data for.
This parameter determines the maximum number of records to return in a single request.
Maximum Value: 1000 records per request
If you do not specify a limit
, the default number of records returned per request will be 100.
This parameter specifies the starting point within the collection of resource results. It's typically used with the limit
parameter to implement pagination.
If you do not specify an offset
, the API will start from the first record.
This parameter enables you to sort the returned data based on a specified field.
The field names you can use to sort data are:
search_volume
year-over-year
rank
rank_trend
percentage_clicks
This parameter determines the sorting direction of the order_by
field. You can sort the data in either ascending (asc
) or descending (desc
) order.
If you do not specify an order_direction
, the default is asc
.
Request samples
Responses
[
{
"keyword": "<string>",
"search_data": {
"search_volume": "<integer>",
"year_over_year": "<double>",
"monthly_searches": {
"search_volume": "<integer>",
"month": "<string>",
"year": "<integer>"
}
},
"ranking_data": {
"updated_on": "<date>",
"rank": "<integer>",
"trend": "<integer>",
"landing_page": "<string>"
},
"serp_data": {
"percentage_clicks": "<number>",
"serp_features": {
"feature": "<string>",
"position": "<integer>"
}
},
"tracked_keyword_id": "<integer>"
},
{
"keyword": "<string>",
"search_data": {
"search_volume": "<integer>",
"year_over_year": "<double>",
"monthly_searches": {
"search_volume": "<integer>",
"month": "<string>",
"year": "<integer>"
}
},
"ranking_data": {
"updated_on": "<date>",
"rank": "<integer>",
"trend": "<integer>",
"landing_page": "<string>"
},
"serp_data": {
"percentage_clicks": "<number>",
"serp_features": {
"feature": "<string>",
"position": "<integer>"
}
},
"tracked_keyword_id": "<integer>"
}
]