Data API / Similarweb / Website

Demographics

Demographics. Response follows the SimilarWeb v5 envelope (meta + data). Date constraint: start_date and end_date must fall in the SAME month (exactly one monthly bucket).

Параметры

запрос

domainstringОбязательный
Target domain, e.g. example.com.
start_datestringОбязательный
Start month, format YYYY-MM.
end_datestringОбязательный
End month, format YYYY-MM.
granularitystringОбязательный
Допустимые значения: monthly
Time granularity. Allowed: monthly.
countrystringНеобязательный
Допустимые значения: us · ww
Two-letter country code. Allowed: us, ww. Default: ww. Coverage is limited to ww and us on the current plan.
web_sourcestringНеобязательный
Допустимые значения: total
Traffic source device split. Allowed: total.
main_domain_onlybooleanНеобязательный
Restrict to the main domain only (true/false).
formatstringНеобязательный
Допустимые значения: json
Response format. Allowed: json.

Пример запроса

curl -G "https://openapi.felo.ai/v1/beta/similarweb/website/demographics" \
  --data-urlencode "domain=<string>" \
  --data-urlencode "start_date=<string>" \
  --data-urlencode "end_date=<string>" \
  --data-urlencode "granularity=<string>" \
  -H "Authorization: Bearer $FELO_API_KEY"

Ответ

Пример ответа

{
  "meta": {
    "request": {
      "format": "json",
      "domain": "cnn.com",
      "granularity": "monthly",
      "country": "us",
      "start_date": "2026-06-01",
      "end_date": "2026-06-30",
      "metrics": [
        "age_18_to_24_share",
        "age_25_to_34_share",
        "age_35_to_44_share",
        "age_45_to_54_share",
        "age_55_to_64_share",
        "age_65_plus_share",
        "male_share",
        "female_share"
      ]
    },
    "status": "success",
    "last_updated": "2026-07-31"
  },
  "data": [
    {
      "age_18_to_24_share": 0.0684928856109901,
      "age_25_to_34_share": 0.16978297333160164,
      "age_35_to_44_share": 0.202684431962113,
      "age_45_to_54_share": 0.2104190356035189,
      "age_55_to_64_share": 0.21167119791609917,
      "age_65_plus_share": 0.1369494755756772,
      "male_share": 0.5816619373492008,
      "female_share": 0.4183380626507992
    }
  ]
}

Поля ответа

metaobjectНеобязательный
SimilarWeb v5 response envelope metadata.
statusstringОбязательный
Operation status; success for a successful lookup.
last_updatedstringНеобязательный
Date of the most recent available data point (YYYY-MM-DD).
requestobjectНеобязательный
Normalized request parameters used for this lookup.
queryobjectНеобязательный
Pagination/sort echo when applicable (limit, offset, asc, sort).
dataobject[]Необязательный
age_18_to_24_sharenumberНеобязательный
age_25_to_34_sharenumberНеобязательный
age_35_to_44_sharenumberНеобязательный
age_45_to_54_sharenumberНеобязательный
age_55_to_64_sharenumberНеобязательный
age_65_plus_sharenumberНеобязательный
male_sharenumberНеобязательный
female_sharenumberНеобязательный