v1

latestOpenAPI 3.1.02026-07-2414103.5 MB

Demographics 2.0: Groups - Total (Desktop & Mobile)

Returns the unique audience share for a cohort of gender and age group of the selected domain and the engagement metrics associated with this cohort.

get/{domain_name}/demographics_v2/groups

Path parameters

domain_namestring required

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

Query parameters

api_keystring required

Your Similarweb API key.

start_datestring required

Start month (format: YYYY-MM). Will default to last 3 months if date not entered.

end_datestring required

End month (format: YYYY-MM). Will default to last 3 months if date not entered.

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.

age_bucketsstring required

Enter the age groups of interest (format: 18, 25, 35, 45, 55, 65)

female_databoolean required

Get data for Females

male_databoolean required

Get data for Males

formatstring

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

Response

200

unique_visitors_rationumber

pages_per_visitnumber

bounce_ratenumber

durationnumber

Example response

{
  "meta": {
    "request": {
      "female_data": true,
      "buckets": [
        35
      ],
      "age_buckets": [
        "35"
      ],
      "format": "json",
      "domain": "cnn.com",
      "start_date": "2023-01-01",
      "end_date": "2023-03-31",
      "country": "us"
    },
    "status": "Success",
    "last_updated": "2023-05-31"
  },
  "unique_visitors_ratio": 0.10009242693902858,
  "pages_per_visit": 2.456954315794069,
  "bounce_rate": 0.507457486203929,
  "duration": 297.76998797162383
}