Services

ResearchPaidGetCountDomainKeywordFilter

Number of paid keywords for a domain in a given country with filter options.



Cost per call: 250.00

Returns the number of keywords in Google's paid search for a given domain in a given country in a given month.

The result can be filtered with a minimum and maximum ranking position e.g. if you want to count only keywords with a ranking position between 1 and 3. Please note that a certain subscription level may be needed to use this call.



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)Domain for which the number of paid keywords is determined.

Format: domain.tld, subdomain.domain.tld
year_month (required)month for which the number of paid keywords should be queried

Format: YYYYMM
position_from (optional)Filter: Lowest ranking of keywords that should be considered in the counting. E.g. if you want to count all keywords starting from the position 4 (meaning 4,5,6 etc.) this parameter has to be set to "4".

Format: 1,2,3 etc.
position_to (optional)Filter: Highest ranking of keywords that should be considered in the counting. E.g. if you want to count 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: 2,3,4 etc


Example

HTTP Request:
http://api.searchmetrics.com/v3/ResearchPaidGetCountDomainKeywordFilter.json?url=searchmetrics.com&countrycode=us&year_month=201301&access_token=xxxxx

Response:
[{
  "693295"
}]


Result Description

KeyDescription
0Number of paid keywords