Services

ProjectTrafficUserSignals

Project traffic user signals



Cost per row: 10.00

This call returns an overview about the project's traffic quality, the so called user signals.

Please note: The API key for this call must be from the account that owns the queried project. API keys from invited users do not work.



Parameter description

GET

ParameterDescription
date_from (required)Start date

Format: YYYYMMDD
date_to (required)End date

Format: YYYYMMDD
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


Example

HTTP Request:
http://api.searchmetrics.com/v3/ProjectTrafficUserSignals.json?project_id=1000&se_id=1&date_from=20150222&date_to=20150321&access_token=xxxxx

Response:

{
	traffic": {
		"count": null,
		"trend": 
		{
			"trend": null,
			"abs": null,
			"per": null
		}
	},
	"seo_traffic": 
	{
		"count": null,
		"per": null,
		"trend": 
		{
			"trend": null,
			"abs": null,
			"per": null
		}
	},
	"ppc_traffic": 
	{
		"count": null,
		"per": null,
		"trend": 
		{
			"trend": null,
			"abs": null,
			"per": null
		}
	},
	"social_traffic": 
	{
		"count": null,
		"per": null,
		"trend": 
		{
			"trend": null,
			"abs": null,
			"per": null
		}
	},
	"time_on_site": 
	{
		"count": null,
		"trend": 
		{
			"trend": null,
			"abs": null,
			"per": null
		}
	},
	"bounce_rate": 
	{
		"count": null,
		"trend": 
		{
			"trend": null,
			"abs": null,
			"per": null
		}
	},
	"pages_per_visit": 
	{
		"count": null,
		"trend": 
		{
			"trend": null,
			"abs": null,
			"per": null
		}

	},
	"page_impressions": 
	{
		"count": null,
		"trend": 
		{
			"trend": null,
			"abs": null,
			"per": null
		}
	}
}


Result Description

KeyDescription
trafficTotal domain traffic for the considered time range
seo_trafficAmount of traffic coming from organic sources within the considered time range
ppc_trafficAmount of traffic coming from paid sources within the considered time range
social_trafficAmount of traffic coming from social sources within the considered time range
time_on_siteAverage time spent from visitors on the site within the considered time range
bounce_rateAverage visitors bounce rate within the considered time range
pages_per_visitAverage number of pages viewed per visits within the considered time range
page_impressionsTotal number of page impressions within the considered time range
countCount value
trendThe element 'trend' can be interpreted as follows
* 0: no change
* 1: pointing up
* -1: going down
absthe absolute change in comparison to the to the parameter [trend_date]
perthe relative/percentual change in comparison to the parameter [trend_date]