Services

ResearchOrganicGetListRankingsKeywordLongtail

Historic rankings for a given keyword in organic search results. (longtail)



Cost per row: 10.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
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/ResearchOrganicGetListRankingsKeywordLongtail.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
  },
  {
    "url": "www.boattrader.com/",
    "title": "Boats for Sale - Buy Boats, Sell Boats, Boating Resources, Boat ...",
    "position": 2,
    "page": 1
  }
]


Result Description

KeyDescription
urlURL of the search engine entry
titleTitle of the search engine entry
positionSERP = search engine ranking position
pageNumber of Google result page