Services

ResearchOrganicGetListRankingsDomainFilter

Keyword rankings for a given domain in organic search results with filter options.



Cost per row: 50.00

This call returns a list keywords of a domain that had rankings in the organic search results in Google in a given country, based on the latest data in our database. Please note that a certain subscription level may be needed to use this call.

Additionally the results can be filtered by position, search volume and/or monthly traffic volume.

The results include a lot of additional information (please check result description) and are orderd by estimated traffic in descending order.



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
url (required)Either a domain or a subdomain

Format: domain.tld, subdomain.domain.tld
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

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

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: string
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: string
search_volume_monthly_from (optional)Filter: Lowest monthly search volume in Google for returned keywords.
E.g. if you want all keywords with a minimum estimated search volume of 300 this parameter has to be set to "300".

Format: integer
search_volume_monthly_to (optional)Filter: Highest estimated monthly search volume for returned keywords.
E.g. if you want all keywords with a maximum estimated monthly search volume of 1000 this parameter has to be set to "1000".

Format: integer
traffic_monthly_from (optional)Filter: Lowest estimated traffic for returned keywords.
E.g. if you want all keywords with a minimum estimated traffic of 300 visitors this parameter has to be set to "300".

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

Format: integer


Example

HTTP Request:
http://api.searchmetrics.com/v3/ResearchOrganicGetListRankingsDomainFilter.json?url=searchmetrics.com&countrycode=us&traffic_monthly_from=30&traffic_monthly_to=400&access_token=xxxxx

Response:
[{
    "keyword": "cnn",
    "position": 1,
    "page": 1,
    "traffic_monthly": 3317104,
    "cpc": 0.54,
    "competition": 0,
    "search_volume_monthly": 10818333,
    "title": "CNN.com - Breaking News, U.S., World, Weather, Entertainment ...",
    "url": "www.cnn.com/",
    "search": "www.cnn.com"
},{
    "keyword": "cnn.com",
    "position": 1,
    "page": 1,
    "traffic_monthly": 327124,
    "cpc": 0.54,
    "competition": 0,
    "search_volume_monthly": 1063583,
    "title": "CNN.com - Breaking News, U.S., World, Weather, Entertainment ...",
    "url": "www.cnn.com/",
    "search": "www.cnn.com"
}]


Result Description

KeyDescription
keywordKeyword
positionRanking position in Google's organic search
pageRanking Page in Google's organic search
traffic_monthlyEstimation of monthly traffic based on search volume and position
cpcEstimated CPC for the keyword
competitionGoogle Advertising competition on the keyword
search_volume_monthlyLocal Google search volume in Google (exact match)
titleTitle of the entry in Google's organic ranking
urlLink-URL of the entry Google's organic ranking
searchURL of the entry as shown in Google's organic ranking