Services

ResearchOrganicGetListRankingsKeyword

Rankings for a given keyword in organic search results.



Cost per row: 10.00

This call returns a list of Google's organic rankings for a given keyword, based on the previous week available in our database and ordered by position in ascending order. As well a trend in comparison to the previous week is returned.



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
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/ResearchOrganicGetListRankingsKeyword.json?countrycode=us&keyword=boat&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.