v1

latestOpenAPI 3.1.02026-07-2414103.5 MB

Demographics 2.0: Age - Total (Desktop & Mobile)

Returns a breakdown of the domain's traffic by age group.

get/{domain_name}/demographics_v2/age

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)

end_datestring required

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.

formatstring

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

Response

200

age_18_to_24number

age_25_to_34number

age_35_to_44number

age_45_to_54number

age_55_to_64number

age_65_plusnumber

Example response

{
  "meta": {
    "request": {
      "format": "json",
      "domain": "cnn.com",
      "start_date": "2023-01-01",
      "end_date": "2023-03-31",
      "country": "us"
    },
    "status": "Success",
    "last_updated": "2023-05-31"
  },
  "age_18_to_24": 0.07851455236424916,
  "age_25_to_34": 0.19966980182513808,
  "age_35_to_44": 0.2126207173674907,
  "age_45_to_54": 0.21221670819437424,
  "age_55_to_64": 0.1915893146015174,
  "age_65_plus": 0.10538890564723032
}