Services

ProjectOrganicGetValueMarketshare

Get the Marketshare for a project or for the tags of a project.



Cost per call: 10.00

This call returns the Searchmetrics Marketshare in the organic search for the project domain and benchmarks based on the latest data in our database.



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/api-calls/searchengines.
Please make sure your project includes the se_id.

Format: integer
url (required)Domains (project or benchmark) 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.

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

Format: string


Example

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


Reponse:
[{
	"date": 20130416,
	"data" : [{
		"domain" : "searchmetrics.com",
		"marketshare" : 12.3,
		"trend": {
			"trend": 1,
			"abs": 10,
			"per": 8.1300813008
    		}

	}]
}]


Result Description

KeyDescription
dateActual date
domainDomain
marketshareMarketshare
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 to the parameter [trend_date]
perthe relative/percentual change in the visibility in comparison to the parameter [trend_date]