Data API / Similarweb / Website

SimilarSites

SimilarSites. Response follows the SimilarWeb v5 envelope (meta + data). Date window (upstream SimilarWeb constraint): start_date and end_date must span EXACTLY 3 consecutive months — a 1- or 2-month span is rejected with upstream error 120 ('must span exactly 3 month(s)'). That span must also be SimilarWeb's most recent supported window, which advances forward each month; an older or out-of-range span is rejected with error 101 ('Dates not in range'). In practice, request the three most recent completed months (e.g. if the latest published month is 2026-07, use start_date=2026-05 and end_date=2026-07). To read the exact currently-supported range, call SimilarWeb's /describe endpoint for this API.

Параметры

запрос

domainstringОбязательный
Target domain, e.g. example.com.
start_datestringОбязательный
Start month, format YYYY-MM. Must be exactly 2 months before end_date: the window has to span exactly 3 consecutive months within SimilarWeb's latest supported range (see the endpoint description).
end_datestringОбязательный
End month, format YYYY-MM. Together with start_date must span exactly 3 consecutive months, and must be the most recent supported month (the window rolls forward monthly; see the endpoint description).
granularitystringНеобязательный
Допустимые значения: monthly
Time granularity. Allowed: monthly.
limitintegerОбязательный
Number of rows to return; max 20, billed as 20 if exceeded.
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Необязательный
Допустимые значения: desktop · mobile_web · total
Traffic source device split. Allowed: desktop, mobile_web, total.
main_domain_onlybooleanНеобязательный
Restrict to the main domain only (true/false).
offsetintegerНеобязательный
Row offset for pagination.
traffic_sourcestringНеобязательный
Traffic-source filter.

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

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

Ответ

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

{
  "meta": {
    "query": {
      "limit": 5,
      "offset": 0,
      "asc": null,
      "sort": null
    },
    "request": {
      "format": "json",
      "domain": "cnn.com",
      "granularity": "monthly",
      "start_date": "2026-05-01",
      "end_date": "2026-07-31",
      "metrics": [
        "rank",
        "affinity",
        "has_adsense"
      ],
      "category": null
    },
    "status": "success",
    "last_updated": "2026-07-31"
  },
  "data": [
    {
      "domain": "bbc.com",
      "category": "News_and_Media",
      "rank": 95,
      "affinity": 1,
      "has_adsense": true
    }
  ]
}

Поля ответа

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[]Необязательный
domainstringНеобязательный
categorystringНеобязательный
rankintegerНеобязательный
affinitynumberНеобязательный
has_adsensebooleanНеобязательный