Services

ResearchPaidGetListPaidVisibilityHistoric

Searchmetrics Paid Visibility for a given URL and a given country in a given timeframe.



Cost per row: 10.00

This call returns the Searchmetrics Visibility Rank in the paid Google search for a domain for a specified country in a given timeframe-

The Paid Visibility displays the visibility of the selected domain in paid search. It is based on the search volume and ad position of the ranked keywords. Each position is weighted individually according to a factor calculated by Searchmetrics. The Paid Visibility factors in the positioning of an ad whether it is a HPA (High Performance Ad= Ad above the organic results) or a PA (Perfomance Ad= Ad next to the organic results).

What does the Paid Visibility show us?

Similar to SEO Visibility, Paid Visibility shows the advertising activity of a domain on Google. Changes in the Paid Visibility could result from budget increases or decreases as well as market changes. Users can also compare the Paid Visibility of competitive domains to assess how much of the potential market a domain is capitalizing on with their pay-per-click campaigns. 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
date_from (required)Start date from which the Paid Visibility should be queried

Format: YYYYMMDD
date_to (required)End date up to which the Paid Visibility should be queried

Format: YYYYMMDD
url (required)Domain for which the Paid Visibility is queried.

Format: domain.tld, subdomain.domain.tld


Example

HTTP Request:
http://api.searchmetrics.com/v3/ResearchPaidGetListPaidVisibilityHistoric.json?url=searchmetrics.com&countrycode=us&date_from=20121001&date_to=20121231&access_token=xxxxx

Response:
[{
    "ebay.com": {
        "20120930": 66,
        "20121007": 1,
        "20121014": 0,
        "20121021": 14,
        "20121028": 140,
        "20121104": 0,
        "20121111": 12,
        "20121118": 3,
        "20121125": 78,
        "20121202": 0,
        "20121209": 13,
        "20121216": 11
    }
}]


Result Description

KeyDescription
YYYYMMDDPaid Visibility of the given domain for the respective date