Services

ProjectOrganicGetValueSeoVisibility

Get the SEO visibility for a project or for the tags of a project.



Cost per row: 10.00

This call returns the Searchmetrics Visibility in the organic search for a project based on the latest data in our database.

Project SEO Visibility differs from general SEO Visibility in that it uses a project selected keywords to evaluate visibility. It is made up of ranking keywords search volumes and positions. Within these figures, each position is ranked individually according to factors determined by Searchmetrics. The nature of a keyword, as either a ranking or navigational keyword, equally influences SEO visibility.

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
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 (project or benchmark) 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: string
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
trend_interval (optional)Set the time range for the trend comparisons. To compare the actual results with the last results use "last" (default). Other possible values are "weekly" (last week) and "monthly" (last month).

Format: string


Example

HTTP Request:
http://api.searchmetrics.com/v3/ProjectOrganicGetValueSeoVisibility.json?project_id=1000&url=domain.tld&se_id=1&access_token=xxxxx


Reponse
[{
    "date": 20130416,
    "sum_visibility": 133,
    "count_keywords": 172,
    "trend": {
        "trend": 1,
        "abs": 10,
        "per": 8.1300813008
    },
    "domain": "searchmetrics.com"
}]


Result Description

KeyDescription
dateActual date
sum_visibilitySEO Visibility
count_keywordsNumber of keywords
domainDomain
trendThe element 'trend' can be interpreted as follows
* 0: no change
* 1: pointing up
* -1: going down
absthe absolute change in the visibility in comparison to the to the parameter [trend_date]
perthe relative/percentual change in the visibility in comparison to the parameter [trend_date]