Services

ResearchContentGetListWinnerUrls

Get the list of the winner urls of a given domain.



Cost per row: 50.00



Parameter description

GET

ParameterDescription
countrycode (required)Country code as specified in ISO 3166-1

Format: US, GB, DE etc
domain (required)The domain for which the top urls is requested.

Format: domain.tld
keyword_limit (optional)Number of keywords return with every url. 0 means no keyword return
limit (optional)Data limit

Format: integer
offset (optional)Data offset


Example

HTTP Request:
http://api.searchmetrics.com/v3/ResearchContentGetListWinnerUrls.json?domain=searchmetrics.com&countrycode=de&date=20150809&offset=0&limit=10&keyword_limit=5&access_token=xxxxx

Response:
[{
	"url" : "http://www.searchmetrics.com/knowledge-base/ranking-factors-us-2013/",
	"title" : "SEO Ranking Factors  Rank Correlation 2013 for Google ...",
	"avg_position" : 14,
	"trend_average_position" : {
		"trend" : 1,
		"abs" : 3,
		"per" : 17.6470588235
         },
	"total_traffic_index" : 20,
	"delta_traffic_index" : 17,
	"total_search_volume" : 12876,
	"total_visibility" : 68,
	"trend_total_visibility" : {
		"trend" : 1,
		"abs" : 31,
		"per" : 83.7837837838
         },
	"avarage_cpc" : 3.1400,
	"keywords" : [{
		"keyword" : "google usa",
		"position" : 12,
		"trend_position" : {
			"trend" : 1,
			"abs" : 9,
			"per" : 42.8571428571
        	 },
		"traffic_index" : 20,
		"trend_traffic_index" : 3,
		"delta_traffic_index" : 17,
		"search_volume" : 12775,
		"cpc" : 3.8400,
         }]
}]Response:
[]


Result Description

KeyDescription
urlA url of the given domain
titleTitle of the url
avg_positionAverage position of the url
total_traffic_indexTraffic index
delta_traffic_indexDelta between traffic index and traffic potential
total_search_volumeRanking keywords aggregated search volume
total_visibilityVisibility of the url
average_cpcAverage cpc of the url
trendThe element 'trend' can be interpreted as follows
* 0: no change
* 1: pointing up
* -1: going down
absThe absolute change in the visibility in comparison to the previous week.
perThe relative/percentual change in the visibility in comparison to the previous week.
keywordThe keyword
positionPosition of the keyword
traffic_indexTraffic index
trend_traffic_indexTrend traffic index
delta_traffic_indexTraffic index delta
search_volumeSearch volume of the keyword
cpcCpc of the keyword
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.