OWStats (0.4.3)

Download OpenAPI specification:Download

This document lists API calls which can be made with owstats API.

Dates format in query parameters is YYYY-MM-DD

Responses are splitted by time intervals, corresponding to "property1" and "property2" in response samples of this documentation.
For performance reasons, depending on the data available in databases and the date range of the request, these time intervals can have different granularities in the response :

  • day : 2020-12-31
  • week : 2020-12-W06
  • month : 2020-12
  • year : 2020

Response sample in documentation :

    {
        "records": {
            "property1": { "visits": [...]},
            "property2": { "visits": [...]}
        }
    }

Possible corresponding response in "real" world :
    {
        "records": {
            "2018": {"visits": [...]},
            "2019-01": {"visits": [...]},
            "2019-W10": {"visits": [...]},
            "2019-03-11": {"visits": [...]}
        }
    }

Browser Visits

For a given domain and time span, it returns the number of sessions aggregated per browser and operating system.
A session corresponds to a visitor browsing one or more website's pages during a time window.
A session ends after 30 minutes of inactivity.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Click truh Pages

For a given domain and time span, it returns the number of occurences of a user navigation between 2 pages of a website.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$
page
integer (Page to be retrieved)
Default: 1

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Domains

It returns the list of subdomains for a given domain name

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": [
    ]
}

Domains Hits

For a given domain and time span, it returns the number of hits aggregated per subdomain.
A hit is a request to get a file (.html, .css, .js, .jpg ..).

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Domains Error Hits

For a given domain and time span, it returns the number of error hits aggregated per subdomain.
An error hit is a request to get a file (.html, .css, .js, .jpg ..) which failed.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Domains valid hits

For a given domain and time span, it returns the number of valid hits aggregated per subdomain.
A valid hit is a successful request to get a file (.html, .css, .js, .jpg ..).

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Domains pages

For a given domain and time span, it returns the number of pages (success and errors) visited aggregated per subdomain.
Response is splitted by time interval.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Domains error pages

For a given domain and time span, it returns the number of pages visited (errors) aggregated per subdomain.
Response is splitted by time interval.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Domains Valid Pages

For a given domain and time span, it returns the number of pages visited (success) aggregated per subdomain.
Response is splitted by time interval.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Geolocalization pages

For a given domain and time span, it returns the number of pages visited (error and success) aggregated per geolocalization of the visitor.
Geolocalization of a user is its country and region.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Geolocalization visits

For a given domain and time span, it returns the number of user sessions aggregated per geolocalization of the visitor.
Geolocalization of a user is its country and region.
A session corresponds to a visitor browsing one or more website's pages during a time window.
A session ends after 30 minutes of inactivity.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Geolocalization Hits

For a given domain and time span, it returns the number of hits aggregated per geolocalization of the visitor.
Geolocalization of a user is its country and region.
A hit is a request to get a file (.html, .css, .js, .jpg ..).

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Hour Hits

For a given domain and time span, it returns the number of hits aggregated per hour (if response is splitted by time interval "day") or per day.
A hit is a request to get a file (.html, .css, .js, .jpg ..).

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Hour Valid Hits

For a given domain and time span, it returns the number of valid hits aggregated per hour (if response is splitted by time interval "day") or per day.
A valid hit is a successful request to get a file (.html, .css, .js, .jpg ..).

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Hour Error Hits

For a given domain and time span, it returns the number of error hits aggregated per hour (if response is splitted by time interval "day") or per day.
An error hit is a failed request to get a file (.html, .css, .js, .jpg ..).

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Hour bytes

For a given domain and time span, it returns the number of bytes transferred aggregated per hour (if response is splitted by time interval "day") or per day.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Hour Bounce pages

For a given domain and time span, it returns the number of times a user visited only one page of the website and left

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Hour entrance pages

For a given domain and time span, it returns the number of times a user entered a website

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Hour exit pages

For a given domain and time span, it returns the number of times a user exited a website

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Hour pages

For a given domain and time span, it returns the number of pages requests (error and success) aggregated per hour (if response is splitted by time interval "day") or per day.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Hour Valid Pages

For a given domain and time span, it returns the number of successful pages requests aggregated per hour (if response is splitted by time interval "day") or per day.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Hour Error pages

For a given domain and time span, it returns the number of pages requests in error aggregated per hour (if response is splitted by time interval "day") or per day.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Hour Pagetime

For a given domain and time span, it returns the number of seconds spent by users on the website.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Hour visits

For a given domain and time span, it returns the number of user sessions aggregated per hour (if response is splitted by time interval "day") or per day.
A session corresponds to a visitor browsing one or more website's pages during a time window.
A session ends after 30 minutes of inactivity.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Hour Average Session Time

For a given domain and time span, it returns the average session time computed per hour (if response is splitted by time interval "day") or per day.
A session corresponds to a visitor browsing one or more website's pages during a time window.
A session ends after 30 minutes of inactivity.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Initial Path Visits

For a given domain and time span, it returns the number of user sessions aggregated per initial path.
Initial path is the first 3 pages of a website browsed by a visitor.
A session corresponds to a visitor browsing one or more website's pages during a time window.
A session ends after 30 minutes of inactivity.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$
page
integer (Page to be retrieved)
Default: 1

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Request Form Valid Hits

For a given domain and time span, it returns the number of valid hits aggregated per form.
A form is the html element form
A valid hit is a successful request to get a file (.html, .css, .js, .jpg ..).

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$
page
integer (Page to be retrieved)
Default: 1

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Robots Bytes

For a given domain and time span, it returns the bytes transferred aggregated per robot type.
Robots are used by many search engines to automatically browse the web and index your site.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Robots Error Hits

For a given domain and time span, it returns the number of error hits aggregated per robot type.
Robots are used by many search engines to automatically browse the web and index your site.
An error hit is a failed request to get a file (.html, .css, .js, .jpg ..).

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Robots Valid Hits

For a given domain and time span, it returns the number of valid hits aggregated per robot type.
Robots are used by many search engines to automatically browse the web and index your site.
A Valid hit is a successful request to get a file (.html, .css, .js, .jpg ..).

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Robots pages hits

For a given domain and time span, it returns the number of hits aggregated per robot type and page.
Robots are used by many search engines to automatically browse the web and index your site.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$
page
integer (Page to be retrieved)
Default: 1

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Status Valid Hits

For a given domain and time span, it returns the number of valid hits aggregated per status code.
A Valid hit is a successful request to get a file (.html, .css, .js, .jpg ..).

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Status Error Hits

For a given domain and time span, it returns the number of error hits aggregated per status code.
An error hit is a failed request to get a file (.html, .css, .js, .jpg ..).

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Status Hits

For a given domain and time span, it returns the number of hits aggregated per status code.
A hit is a request to get a file (.html, .css, .js, .jpg ..).

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Status Valid Pages

For a given domain and time span, it returns the number of valid pages requests aggregated per status code.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Status Error Pages

For a given domain and time span, it returns the number of failed pages requests aggregated per status code.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}

Status Pages

For a given domain and time span, it returns the number of pages requests aggregated per status code.

path Parameters
domain
required
string (Domain to query)
query Parameters
subdomain
string (Subdomain to query)
Default: ""
start_date
required
string (Start of the selection) ^\d{4}-\d{2}-\d{2}$
end_date
required
string (End of the selection (inclusive)) ^\d{4}-\d{2}-\d{2}$

Responses

Response samples

Content type
application/json
{
  • "records": {
    }
}