v1

latestOpenAPI 3.1.02026-07-2414103.5 MB

Visits - Total (Desktop & Mobile)

Returns the estimated number of all visits to a given domain: desktop and mobile visits combined. Historical data goes back 37 months, depending on your subscription.

get/{domain_name}/total-traffic-and-engagement/visits

Path parameters

domain_namestring required

Enter website of interest, without 'www.' or brackets {}

Query parameters

api_keystring required

Your Similarweb API key.

start_datestring

Start month (format: YYYY-MM)

end_datestring

End month (format: YYYY-MM)

countrystring required

Country filter, as a 2-letter ISO country code, or "world" for worldwide. To see the country filters you have access to, please refer to the Check Capabilities endpoint.

granularitystring required

Set the granularity for the returned values. Can be 'daily', 'weekly' or 'monthly'.

main_domain_onlystring

[optional] Return values for the main domain only ('true'), or include also the subdomains ('false')

formatstring

[optional] Format in which the reply should be returned. Possible values: 'json' (default) or 'xml'

show_verifiedstring

[optional] Show shared Google Analytics data when available. Default value is 'false'

mtdstring

[optional] When 'true', end_date is set to the latest available days' data (month-to-date). To use, set granularity to 'daily'. Default value is 'false'.

engaged_onlystring

[optional] When 'true', the data is filtered by 'engaged visits' only.

Response

200

Example response

{
  "meta": {
    "request": {
      "granularity": "Monthly",
      "format": "json",
      "domain": "amazon.com",
      "start_date": "2023-01-01",
      "end_date": "2023-03-31",
      "country": "us"
    },
    "status": "Success",
    "last_updated": "2023-05-31"
  },
  "visits": [
    {
      "date": "2023-01-01",
      "visits": 1999194357.4757116
    }
  ]
}