v1

latestOpenAPI 3.1.02026-07-2414103.5 MB

Geography - Desktop

Returns the desktop traffic share, visits, pages per visit, average time, bounce rate and rank broken down by country, between the selected dates (min. 1 month).

get/{domain_name}/geo/traffic-by-country

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)

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'.

limitstring

[optional] Select the number of results that are returned. Default = 100.

offsetstring

[optional] Specify an offset from where to start returning data.

sortstring

[optional] The metric you'd like the results to be ordered by.

ascstring

[optional] The order of results. Enter "true" for ascending, or "false" for descending.

Response

200

Example response

{
  "meta": {
    "query": {
      "limit": 100
    },
    "request": {
      "format": "json",
      "domain": "cnn.com",
      "country": "world"
    },
    "status": "Success",
    "last_updated": "2023-06-16"
  },
  "records": [
    {
      "country": 840,
      "share": 0.7671226298226229,
      "visits": 126258862.36531453,
      "pages_per_visit": 2.587978560186303,
      "average_time": 337.6757562524412,
      "bounce_rate": 0.4928170158403888,
      "rank": 34,
      "country_name": "United States"
    }
  ]
}