Services

ProjectOrganicGetListUniversalVisibility

Universal visibility for a project or benchmark domain in organic search results



Cost per row: 10.00

This call returns the universal visibility for the monitored keywords for a domain (either a project or a benchmark domain) in the organic search results in a given country.

Please note: The API key for this call must be from the account that owns the queried project. API keys from invited users do not work.



Parameter description

GET

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

Format: YYYYMMDD
date_to (required)End date to which the marketshare 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. Several domains must be separated with a comma without blank.
Please use the exact name that is used within the project. E.g "www.searchmetrics.com" instead of "searchmetrics.com".

Format: domain1.tld,domain2.tld
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
types (optional)Comma separated list of universal type. Possible values are: news, images, video and maps

Format: string


Example

HTTP Request:
http://api.searchmetrics.com/v3/ProjectOrganicGetListUniversalVisibility.json?project_id=1000&url=domain.tld&se_id=1&date_from=yyyymmdd&date_to=yyyymmdd&types=images,video&tags=tag1,tag2&access_token=xxxxx

Response:
[
   {
        "date" : 20150430,
        "data" : [
                   {
                     "visibility" : [
                                      {
                                        "sum_visibility" : 2780,
                                        "count_keywords" : 14,
                                        "type" : "images
                                      }
                                    ],

                     "domain" : "conrad.de"
                   }
                ]

   }
]


Result Description

KeyDescription
dateActual date
domainDomain of the entry
sum_visibilityVisibility of all keywords of this type
count_keywordsNumber of keywords of this type
typeUniversal type