Docs
Szukaj w dokumentacji...⌘K

Top pages

API + MCPTylko Enterprise
POST/v3/site-explorer/traffic-top-pages

The request fails when the target is too large for its top pages to be computed in time.

Requires the Traffic Analytics Enterprise add-on.

Treść żądania

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.

Dozwolone wartości:exactprefixdomainsubdomains
Default:subdomains
protocolstring

The protocol of your target.

Dozwolone wartości:bothhttphttps
Default:both
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).

whereobject

where filters the visits by the report's dimensions, which changes the totals and the shares, and the rows by their metrics, which does not. On the dimensions, isubstring ignores the case and eq, prefix and suffix match it, but on search_term, which ignores it.

searchstring

Only the rows whose label contains this text, case-insensitive. It narrows the rows and not the totals, so the shares stay those of the whole report.

order_bystring

A field to order the results by, with optional direction. Format: field_name:asc or field_name:desc (default desc).

Example:field_a:asc
limitinteger

The number of rows to return (1 to 100).

Min.:1Max:100
Default:100
offsetinteger

The number of rows to skip.

Min.:0
Default:0
outputstring

The output format.

Dozwolone wartości:jsonphp

Odpowiedzi

pagesarray<object>
avg_time_on_pageinteger or null

The estimated average time from a view of the page to the next page view of the same visit, in seconds.

entry_bounce_ratenumber (float) or null

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

entry_pages_per_visitnumber (float) or null

The estimated number of page views per visit, over the visits that started on the page.

entry_pageviewsinteger or null

The estimated number of page views in the visits that started on the page.

entry_visit_durationinteger or null

The estimated average duration, in seconds, of the visits that started on the page.

exit_ratenumber (float) or null

The estimated share of the page's views that were the last of their visit, as a percent.

organic_trafficinteger or null

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

page_typestring or null

Comma-separated page type paths, such as /Article/How_to,/Landing_Page. Only the most specific path per parent group is included. Null when the page's classification is unavailable.

pageviewsinteger

The estimated number of page views.

sharenumber (float)

The share of the target's page views, as a percent.

urnumber (float) or null

The URL Rating of the page, on a 100-point scale.

urlstring (url)

The URL of the page.

visitorsinteger

The estimated number of unique visitors, counted per day: a person who visits on two days counts twice.

visitsinteger

The estimated number of visits in the period. Visits that enter from the target's own website are not counted.