Services

ProjectOrganicGetListPositionSpreadHistoric

Get the historic ranking distribution of the project among the top five search results by positions



Cost per row: 100.00

Position Spread indicates the percentage ranking distribution for the selected tag, domain and search engine combination.

Please note that a certain subscription level may be needed to use this call.



Parameter description

GET

ParameterDescription
date_to (required)End date to which the position spread should be queried

Format: YYYYMMDD
limit (required)Number of day to which the position spread should be queried
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/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: string
tags (optional)Comma separated list of tags. Please note: When using more than one tag only keywords with both tags will be included

Format: string


Example

HTTP Request:
http://api.searchmetrics.com/v3/ProjectOrganicGetListPositionSpreadHistoric.json?project_id=1000&se_id=1&url=searchmetrics.com&date_to=20130521&limit=5&access_token=xxxxx

Response:
[{
	"date": "20150227",
	"data":[{
		"domain_id": "543321",
    		"positions": {
			"position1": 
				{
					"keyword_count": 2,
					"keyword_per": 1.0989010989
				},
			"position2":
				{
					"keyword_count": 4,
					"keyword_per": 2.1978021978
				},
			"position3":
				{
					"keyword_count": 12,
					"keyword_per": 6.5934065934
				},
			"position4":
				{
					"keyword_count": 12,
					"keyword_per": 6.5934065934

				},
			"position5":
				{
					"keyword_count": 4,
					"keyword_per": 2.1978021978
				},
			"position6":
				{
					"keyword_count": 13,
					"keyword_per": 7.1428571429
				},
			"position7":
				{
					"keyword_count": 3,
					"keyword_per": 1.6483516484
				},
			"position8":
				{
					"keyword_count": 5,
					"keyword_per": 2.7472527473
				},
			"position9":
				{
					"keyword_count": 11,
					"keyword_per": 6.043956044
				},
			"position10":
				{
					"keyword_count": 3,
					"keyword_per": 1.6483516484
				}
		},
		"domain": "teilehaber.de"
	}]

}]


Result Description

KeyDescription
dateDate of one of the requestet days
domainDomain
keyword_countNumber of keywords with this position
keyword_perThe percentual value of the keyword_count in comparision of all keywords