Services

ProjectPerformanceGetListUrlRankings

Get the rankings for all urls, belongs to the given project



Cost per call: 1.00

Get the rankings for all urls, belongs to the given project



Parameter description

GET

ParameterDescription
project_id (required)ID of the project that should be queried.
The ID can be found in the URL when viewing the project in the Searchmetrics Suite.

Format: Integer
se_id (required)ID of the search engine that should be queried. A complete list of IDs can be found http://api.searchmetrics.com/v3/api-calls/searchengines.
Please make sure your project includes the se_id."

Format: integer
url (required)Domains within the project that should be queried. Several domains must be separated with a comma without blank.
Please use the exact name that is used within the project. E.g "www.searchmetrics.com" instead of "searchmetrics.com".

Format: domain1.tld,domain2.tld
keyword_limit (optional)Limit for the number of responsed keywords per url

Format: integer
limit (optional)Limit for the number of result rows
Permitted values are 10, 25, 50, 100, 250

Format: integer
offset (optional)Offset for result set
Must be a multiple of allowed values for the parameter "limit"

Format: integer
trend_interval (optional)Set the time range for the trend comparisons. To compare the actual results with the last results use "last" (default). Other possible values are "weekly" (last week) and monthly (last month).

Format: string


Example

HTTP Request
http://api.searchmetrics.com/v3/ProjectPerformanceGetListUrlRankings.json?project_id=1000&se_id=1&url=searchmetrics.com&access_token=xxxxx


Response:
[{
	"url" : "http://www.searchmetrics.com/",
	"keywords" : [{
		"keyword" : "seo",
		"position" : 1,
		"traffic" : 87940,
		"traffic_volume" : 330166,
		"cpc" : 0.49,
		"page" : 1
		"trend" : {
			"trend" : 0
			"abs" : 0
			"per" : 0
		},
	}]
}]


Result Description

KeyDescription
urlURL of the entry in the organic ranking
keywordKeyword
positionRanking position of the keyword in the organic search
trafficEstimation of traffic based on search volume and position
traffic_volumeEstimated traffic volume per month.
cpcEstimated CPC for the keyword in EUR.
pageRanking page of the keyword in the organic search
trendThe element 'trend' can be interpreted as follows
* 0: no change
* 1: pointing up
* -1: going down

perthe relative/percentual change in the visibility in comparison to the parameter [trend_date]
absthe absolute change in the visibility in comparison to the to the parameter [trend_date]