Services

ResearchKeywordsGetListLosersFilter

Keywords with the highest absolute losses in organic search traffic for a given domain with filter options



Cost per row: 100.00

This call returns the keywords with the biggest losses in absolute search volumes in comparison to the previous week for a given domain for a given point in time. Please note that a certain subscription level may be needed to use this call.

Several filter options are available.



Parameter description

GET

ParameterDescription
countrycode (required)A two letter country code as specified in ISO 3166-1

Format: http://api.searchmetrics.com/api-calls/countries
date (required)Date for which the winners are queried

Format: YYYYMMDD
url (required)Either a domain or subdomain

Format: domain.tld, subdomain.domain.tld
cpc_from (optional)Filter: Lowest estimated CPC for returned keywords.
E.g. if you want all keywords with a minimum estimated CPC of 1€ visitors this parameter has to be set to "1".

Format: integer
cpc_to (optional)Filter: Highest estimated CPC for returned keywords.
E.g. if you want all keywords with a maximum estimated CPC of 2 this parameter has to be set to "2".

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

Format: EUR, USD etc.
delta_position_from (optional)Filter: Lowest change in position of a keyword that should be returned.
E.g. if you want all keywords with a change of 4 or less positions this parameter has to be set to "-4".

Format: integer
delta_position_to (optional)Filter: Highest change in position of a keyword that should be returned.
E.g. if you want all keywords with a change of 10 or more positions this parameter has to be set to "-10".

Format: integer
delta_traffic_from (optional)Filter: Lowest change in traffic of a keyword that should be returned.
E.g. if you want all keywords with a change of 50 or less visitors this parameter has to be set to "-50".

Format: integer
delta_traffic_to (optional)Filter: Highest change in traffic of a keyword that should be returned.
E.g. if you want all keywords with a change of 1000 or more visitors this parameter has to be set to "-1000".

Format: integer
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
position_from (optional)Filter: Lowest ranking of keywords that should be returned.
E.g. if you want all keywords starting from the position 4 (meaning 4,5,6 etc.) this parameter has to be set to "4".

Format: integer
position_to (optional)Filter: Highest ranking of keywords that should be returned.
E.g. if you want all keywords up to position 3 ( resulting in all keywords with a SERP of 1, 2 or 3) this parameter has to be set to "3".

Format: integer


Example

HTTP Request:
http://api.searchmetrics.com/v3/ResearchKeywordsGetListLosersFilter.json?url=searchmetrics.com&countrycode=us&date=20130127
&access_token=xxxxx

Response:
[
	{
		"position": [int],
		"trend_position": [int],
		"position_last": [int],
		"delta_traffic_monthly": [int],
		"search_volume_monthly": [int],
		"cpc": [int],
		"traffic_monthly": [int],
		"traffic_monthly_last": [int],
		"url": [string],
		"keyword": [string],
		"search": [string]
	}
]


Result Description

KeyDescription
positionActual position of the given domain for the respective keyword in Google's organic search index.
trend_positionDifference in keyword position between current and previous month.
position_lastPosition of the given domain for the respective keyword in Google's organic search index in the previous month.
delta_traffic_monthlyDifference in estimated monthly traffic between current and last month via the respective keyword for the given domain.
search_volume_monthlyEstimated search volume in Google for the respective Keyword.
cpcEstimated CPC in Google Adwords for the respective keyword.
traffic_monthlyEstimated current monthly traffic of the given domain from Google via the respective keyword.
traffic_monthly_lastEstimated monthly traffic last month of the given domain from Google via the respective keyword.
urlURL of the indexed landing page.
keywordKeyword for which the data is shown.
searchURL of the indexed landing page as shown in Google.