Historic rankings for a given keyword in paid search results.

Cost per row: 50.00

This call returns a list of Google's paid rankings for a given keyword, based on the latest rankings available in our database and ordered by position in ascending order. As well a trend in comparison to the previous data point is returned. Please note that a certain subscription level may be needed to use this call.

Parameter description


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

date (required)Date

keyword (required)Keyword for which the rankings are determined

Format: string
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: [{         "url": "",         "title": "Boat - Wikipedia, the free encyclopedia",         "position": 1,         "page": 1,         "trend": {             "trend": 0,             "abs": 0,             "per": 0         } },{         "url": "",         "title": "Boats for Sale - Buy Boats, Sell Boats, Boating Resources, Boat ...",         "position": 2,         "page": 1,         "trend": {             "trend": 0,             "abs": 0,             "per": 0         } }]

Result Description

urlURL of the search engine entry
titleTitle of the search engine netry
positionSERP = search engine ranking position
pageNumber of Google result page
trendThe element 'trend' can be interpreted as follows
* 0: no change
* 1: pointing up
* -1: going down
absThe absolute change in the position in comparison to the previous week.
perThe relative/percentual change in the position in comparison to the previous week.