Services

ResearchOrganicGetListRankingsKeywordHistoric

Historic rankings for a given keyword in organic search results.



Cost per row: 50.00

This call returns a list of Google's organic 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

GET

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

Format: http://api.searchmetrics.com/api-calls/countries
date (required)Date

Format: YYYYMMDD
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


Example

HTTP Request:
http://api.searchmetrics.com/v3/ResearchOrganicGetListRankingsKeywordHistoric.json?countrycode=us&keyword=boat&date=20130127&access_token=xxxxx

Response:
[{
        "url": "en.wikipedia.org/wiki/Boat",
        "title": "Boat - Wikipedia, the free encyclopedia",
        "position": 1,
        "page": 1,
        "trend": {
            "trend": 0,
            "abs": 0,
            "per": 0
        }
},{
        "url": "www.boattrader.com/",
        "title": "Boats for Sale - Buy Boats, Sell Boats, Boating Resources, Boat ...",
        "position": 2,
        "page": 1,
        "trend": {
            "trend": 0,
            "abs": 0,
            "per": 0
        }
}]


Result Description

KeyDescription
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.