Historic keyword rankings for a given domain in paid search results.

Cost per row: 50.00

This call returns a list keywords of a domain that had rankings in the paid search results in Google in a given country in a given week. Please note that a certain subscription level may be needed to use this call. The result includes a lot of additional information (please check result description) and are orderd by estimated traffic in descending order.

Parameter description


countrycode (required)A two letter country code as specified in ISO 3166-1

date (required)Date

url (required)Either a domain or subdomain

Format: domain.tld, subdomain.domain.tld
currency (optional)Currency code as specified in ISO 4217. Default is "EUR".

Format: EUR, USD etc.
limit (optional)Limit for the number of result rows
Permitted values are 10, 25, 50, 100, 250
Default is 10

Format: integer
offset (optional)Offset for result set
Must be a multiple of allowed values for the parameter "limit"
Default is 0

Format: integer


HTTP Request:  Response: [{     "keyword": "cnn",     "position": 1,     "page": 1,     "traffic_monthly": 3317104,     "cpc": 0.54,     "competition": 0,     "search_volume_monthly": 10818333,     "title": " - Breaking News, U.S., World, Weather, Entertainment ...",     "url": "",     "search": "" },{     "keyword": "",     "position": 1,     "page": 1,     "traffic_monthly": 327124,     "cpc": 0.54,     "competition": 0,     "search_volume_monthly": 1063583,     "title": " - Breaking News, U.S., World, Weather, Entertainment ...",     "url": "",     "search": "" }]

Result Description

positionRanking position in Google's organic search
pageRanking Page in Google's organic search
traffic_monthlyEstimation of monthly traffic based on search volume and position
cpcEstimated CPC for the keyword
competitionGoogle Advertising competition on the keyword
search_volume_monthlyLocal Google search volume in Google (exact match)
titleTitle of the entry in Google's organic ranking
urlLink-URL of the entry Google's organic ranking
searchURL of the entry as shown in Google's organic ranking