Services

ProjectTrafficGetListKeywordTrafficPotentials

Get a list of keyword traffic potentials



Cost per row: 10.00

The keyword traffic potentials table displays keywords that have attracted visits to the project domain for the selected time period and search engine, but also have a low potential utilization. Additional the SEO traffic potential (calculated through Google / AdWords) for keywords without SEO traffic is displayed. Results are sorted automatically, increasing according to traffic potential utilization.



Parameter description

GET

ParameterDescription
date_from (required)Start date from which the traffic potentials should be queried

Format: YYYYMMDD
date_to (required)End date to which the traffic potentials should be queried

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
url (required)Domains within the project that should be queried.
Please use the exact name that is used within the project. E.g "www.searchmetrics.com" instead of "searchmetrics.com".

Format: string
currency (optional)Currency code as specified in ISO 4217. Default is "EUR".

Format: EUR, USD etc.
limit (optional)Limit for the number of result rows
Permitted values are 10, 25, 50, 100, 250
Default is 10

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

Format: integer
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/ProjectOrganicGetListKeywordTrafficPotentials.json?project_id=1000&se_id=1&url=searchmetrics.com&date_from=20130419&date_to=20130518&access_token=xxxxx

Response:
[
	{
		"keyword": [string],
		"url": [string],
		"position": [int],
		"traffic": [int],
		"seo_value": [int],
		"traffic_potential": [int],
		"pot_utilization": [int],
		"traffic_volume": [int],
		"cpc": [int],
		"keyword_difficulty": [int],
		"date": [int],
		"bounce_rate": [int],
		"time_on_site": [int],
		"pages_per_visit": [int],
		"conversion_rate_1": [int],
		"conversion_rate_2": [int],
		"conversion_rate_3": [int],
		"conversion_rate_4": [int],
		"estimation": [string],
		"delta_traffic": [int],
		"trend_date": [int],
		"trend": {
			"min": [int],
			"max": [int],
			"trend": [int],
			"abs": [int],
			"per": [float]
			}
	}
]


Result Description

KeyDescription
keywordKeyword
urlBest URL in the specified interval (date_from, date_to)
positionBest position of the URL
trafficTraffic for the URL
seo_valueSEO value
traffic_potentialSEO traffic potential
pot_utilizationTraffic potential usage
traffic_volumetraffic_volume
cpcEstimated CPC in AdWords for the specific keyword.
keyword_difficultyThe keyword difficulty is an indicator how easy it will be to optimize the specific keyword. 0 means very easy and 100 means very difficult.
dateDate when the best ranking was found
bounce_rateBounce rate within the specified date interval
time_on_siteTime on site within the specified date interval
pages_per_visitPages per visit within the specified date interval
conversion_rate_1Conversion rate for conversion target 1
conversion_rate_2Conversion rate for conversion target 2
conversion_rate_3Conversion rate for conversion target 3
conversion_rate_4Conversion rate for conversion target 4
estimationIndicator if traffic values are based on real data (null) or if it is based on Google data ("google")
delta_trafficDelta traffic is the difference of traffic for the previous date interval
trend_dateDate when the best ranking at the trend-interval was found
minMinimum SEO value potential
maxMaximum SEO value potential
trend The 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 trend interval
perthe relative/percentual change in the visibility in comparison to the trend interval