Felo API PlatformFelo API Platform

数据 API / Similarweb / Website

Deduplicated Audience

Deduplicated Audience. 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/deduplicated-audience" \
  --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",
      "metrics": [
        "total_deduplicated_audience",
        "desktop_only_audience_share",
        "desktop_only_audience_visitors",
        "mobile_web_only_audience_share",
        "mobile_web_only_audience_visitors",
        "desktop_and_mobile_web_audience_share",
        "desktop_and_mobile_web_audience_visitors"
      ],
      "main_domain_only": true
    },
    "status": "success",
    "last_updated": "2026-07-31"
  },
  "data": [
    {
      "date": "2026-06-01",
      "total_deduplicated_audience": 23727616.32935698,
      "desktop_only_audience_share": 0.12370405221553608,
      "desktop_only_audience_visitors": 2935202.2893569823,
      "mobile_web_only_audience_share": 0.4979319281532382,
      "mobile_web_only_audience_visitors": 11814737.749356981,
      "desktop_and_mobile_web_audience_share": 0.3783640196312258,
      "desktop_and_mobile_web_audience_visitors": 8977676.290643018
    }
  ]
}

响应字段

  • 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可选
  • total_deduplicated_audiencenumber可选
  • desktop_only_audience_sharenumber可选
  • desktop_only_audience_visitorsnumber可选
  • mobile_web_only_audience_sharenumber可选
  • mobile_web_only_audience_visitorsnumber可选
  • desktop_and_mobile_web_audience_sharenumber可选
  • desktop_and_mobile_web_audience_visitorsnumber可选