Docs
Dokumentation durchsuchen...⌘K

Competitor overlap

API + MCPNur Enterprise
POST/v3/site-explorer/traffic-competitor-overlap

Requires the Traffic Analytics Enterprise add-on.

Anfrage-Body

selectarray<string>Required

A list of fields to return.

Example:["field_a","field_b"]
targetstring (url)Required

The target of the search: a domain or a URL.

modestring

The scope of the target.

Zulässige Werte:exactprefixdomainsubdomains
Default:subdomains
protocolstring

The protocol of your target.

Zulässige Werte:bothhttphttps
Default:both
countrystring

Only the visitors from this country, as a two-letter country code (ISO 3166-1 alpha-2): the target's visitors, their visits to the other websites and the average visitor. Every country when absent.

date_fromstring (date)

The first day of the period in YYYY-MM-DD format (UTC). The period defaults to the last 30 days with estimates and is clamped to the days with estimates. Must not be after date_to.

date_tostring (date)

The last day of the period in YYYY-MM-DD format (UTC).

compare_witharray<string (url)>

Websites (whole domains, up to 10) to compare the target's audience with. When absent, the target's top organic competitors in competitor_country.

Default:[]
competitor_countrystring

The country whose organic competitors of the target are compared, as a two-letter country code (ISO 3166-1 alpha-2), independent of country; the target's top organic country when absent. Ignored with compare_with.

Zulässige Werte:adaeafagaialamaoarasatauawazba…
limitinteger

The number of websites to return, the most shared visitors first; every compared website when absent.

Min:1
outputstring

The output format.

Zulässige Werte:jsonphp

Antworten

websitesarray<object>
bounce_ratenumber (float)

The estimated share of the visits that viewed a single page, as a percent.

drnumber (float)

The Domain Rating of the website, on a 100-point scale.

organic_trafficinteger

The estimated monthly organic search traffic of the website or page.

pages_per_visitnumber (float)

The estimated number of page views per visit.

shared_of_targetnumber (float)

The share of the target's visitors who also visited the website, as a percent.

shared_of_websitenumber (float)

The share of the website's visitors who also visited the target, as a percent.

shared_visitorsinteger

The estimated number of unique visitors of both the target and the website in the period, never more than either website's visitors.

traffic_mixarray<object> or null

The website's traffic mix: the share of its visits by acquisition channel, largest first, every channel with visits. Visits from the website's own pages are not counted; with country, only the visits from that country. Null when too few of the website's visitors are known to estimate it.

channelstring

The acquisition channel: search is organic search and organic shopping, referral includes affiliates, email includes newsletters, ai is AI assistants and AI search, paid is every kind of advertising, other is anything else (SMS, push notifications, audio...).

Zulässige Werte:directsearchreferralsocialemailaipaidother
sharenumber (float)

The share of the website's visits that came through the channel, as a percent.

visit_durationinteger

The estimated average visit duration, in seconds. Visits of a single page, whose length is unknown, are left out.

visitorsinteger

The estimated number of unique visitors of the website in the period, each counted once however many days they visited.

visitors_fromobject or null

Where the website's visitors come from: the share of its visitors by country, by UN M49 subregion and by continent, largest first, over every country. Only the places with enough visitors to show are listed: what their shares leave of 100 is the visitors from everywhere else. Null when too few of the website's visitors are known to estimate it. Not available with country.

countriesarray<object>

The shares by country, largest first.

placestring

The place: a two-letter country code (ISO 3166-1 alpha-2) in countries, a UN M49 subregion name in subregions, a continent name in continents.

sharenumber (float)

The share of the website's visitors who are from the place, as a percent.

subregionsarray<object>

The shares by UN M49 subregion, largest first.

placestring

The place: a two-letter country code (ISO 3166-1 alpha-2) in countries, a UN M49 subregion name in subregions, a continent name in continents.

sharenumber (float)

The share of the website's visitors who are from the place, as a percent.

continentsarray<object>

The shares by continent, largest first.

placestring

The place: a two-letter country code (ISO 3166-1 alpha-2) in countries, a UN M49 subregion name in subregions, a continent name in continents.

sharenumber (float)

The share of the website's visitors who are from the place, as a percent.

websitestring

The compared website, as given or as the organic competitors report lists it.