資料 API / Similarweb / Website

Website Ranking

Website Ranking. Response follows the SimilarWeb v5 envelope (meta + data). Date constraint: the start_date-end_date span must cover between 1 and 120 monthly buckets.

參數

查詢

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. Default: 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選填
允許值： desktop · mobile_web · total
Traffic source device split. Allowed: desktop, mobile_web, total.
main_domain_onlyboolean選填
Restrict to the main domain only (true/false). Default: True.

請求範例

curl -G "https://openapi.felo.ai/v1/beta/similarweb/website/ranking" \
  --data-urlencode "domain=<string>" \
  --data-urlencode "start_date=<string>" \
  --data-urlencode "end_date=<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",
      "web_source": "total",
      "metrics": [
        "country_rank",
        "category_rank",
        "category"
      ]
    },
    "status": "success",
    "last_updated": "2026-07-31"
  },
  "data": [
    {
      "date": "2026-06-01",
      "country_rank": 69,
      "category": "News_and_Media",
      "category_rank": 5
    }
  ]
}

回應欄位

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[]選填
datestring選填
country_rankinteger選填
categorystring選填
category_rankinteger選填