Services

ResearchUniversalGetListRankingsDomainFilter

Historic keyword rankings for a given domain in universal search results with filter options.



Cost per row: 50.00

This call returns a list keywords of a domain that had rankings in the universal search results in Google in a given country for a given date with several filter options.

The result includes a lot of additional information (please check result description) and are ordered by estimated traffic in descending order.

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 for which the universal rankings are queried

Format: YYYYMMDD
type (required)Universal search type. Possible values are universal, news, maps, video, images and shopping.

Format: string (e.g type4, type5 etc.)
url (required)Either a domain, a subdomain or a directory

Format: domain.tld, subdomain.domain.tld, domain.tld/directory/
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
position_from (optional)Filter: Lowest ranking of keywords that should be returned.
E.g. if you want all keywords starting from the position 4 (meaning 4,5,6 etc.) this parameter has to be set to "4".

Format: integer
position_to (optional)Filter: Highest ranking of keywords that should be returned.
E.g. if you want all keywords up to position 3 ( resulting in all keywords with a SERP of 1, 2 or 3) this parameter has to be set to "3".

Format: integer
search_volume_monthly_from (optional)Filter: Lowest monthly search volume in Google for returned keywords.
E.g. if you want all keywords with a minimum estimated search volume of 300 this parameter has to be set to "300".

Format: integer
search_volume_monthly_to (optional)Filter: Highest estimated monthly search volume for returned keywords.
E.g. if you want all keywords with a maximum estimated monthly search volume of 1000 this parameter has to be set to "1000".

Format: integer
traffic_monthly_from (optional)Filter: Lowest estimated traffic for returned keywords.
E.g. if you want all keywords with a minimum estimated traffic of 300 visitors this parameter has to be set to "300".

Format: integer
traffic_monthly_to (optional)Filter: Highest estimated traffic for returned keywords.
E.g. if you want all keywords with a maximum estimated traffic of 1000 visitors this parameter has to be set to "1000".

Format: integer


Example

HTTP Request
http://api.searchmetrics.com/v3/ResearchUniversalGetListRankingsDomainFilter.json?url=searchmetrics.com&countrycode=us&date=20130127&type=universal&access_token=xxxxx

Response:
[{
    "keyword": "cnn com",
    "position": 1,
    "page": 1,
    "traffic_monthly": 1092,
    "cpc": 0.46,
    "type": "news",
    "competition": 0,
    "search_volume_monthly": 31333,
    "title": "Hunters may have found missing Iowa cousins",
    "url": "www.cnn.com/2012/12/05/us/iowa-missing-girls/index.html",
    "search": "www.cnn.com/2012/12/05/us/iowa-missing-girls/"
},{
    "keyword": "the rock",
    "position": 3,
    "page": 2,
    "traffic_monthly": 896,
    "cpc": 0.6,
    "type": "images",
    "competition": 0,
    "search_volume_monthly": 24625,
    "title": "Images",
    "url": "sportsillustrated.cnn.com/2008/extramustard/06/11/barack-obama-the-rock-tale/index.html",
    "search": "sportsillustrated.cnn.com/2008/extramustard/06/11/barack-obama-the-rock-tale/"
}]


Result Description

KeyDescription
keywordKeyword
positionRanking position in Google's universal search
pageRanking Page in Google's universal search
traffic_monthlySearchmetrics indicator for the traffic, calculated with search volume and position
cpcEstimated CPC for the keyword in EUR
typeUniversal search result type
competitionAn indicator for the advertising competition on that keyword
search_volume_monthlyGoogle search volume in the chosen country (exact match)
titleTitle of the entry in Google's ranking
urlLink-URL of the entry Google's ranking
searchURL of the entry as shown in Google's ranking