Services

ResearchPaidGetListRankingsDomainHistoric

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

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


Example

HTTP Request: http://api.searchmetrics.com/v3/ResearchPaidGetListRankingsDomainHistoric.json?url=searchmetrics.com&countrycode=us&date=20121216&access_token=xxxxx  Response: [{     "keyword": "cnn",     "position": 1,     "page": 1,     "traffic_monthly": 3317104,     "cpc": 0.54,     "competition": 0,     "search_volume_monthly": 10818333,     "title": "CNN.com - Breaking News, U.S., World, Weather, Entertainment ...",     "url": "www.cnn.com/",     "search": "www.cnn.com" },{     "keyword": "cnn.com",     "position": 1,     "page": 1,     "traffic_monthly": 327124,     "cpc": 0.54,     "competition": 0,     "search_volume_monthly": 1063583,     "title": "CNN.com - Breaking News, U.S., World, Weather, Entertainment ...",     "url": "www.cnn.com/",     "search": "www.cnn.com" }]


Result Description

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