Felo API PlatformFelo API Platform
全部 Similarweb 端点
v0.2.0-beta
OpenAPI 3.1.0

流量与互动

服务器:https://openapi.felo.ai
客户端库

Website Analytics

​

Website traffic, engagement, audience, rankings and search data.

流量与互动

​

流量与互动。响应采用 SimilarWeb v5 信封结构(meta + data)。日期约束:start_date 至 end_date 的区间必须覆盖 1 至 120 个月度分桶。

计费参考

  • 计量方式:套餐资源单位。
  • 参考请求估算:0.075 美元。
  • 单位成本基准:0.075 美元。
  • 资源单位:similarweb_credit。
  • 参考客户倍率:1.0。不得对已结算的客户金额再次应用。
  • 成本基准不构成最终客户价格,即使为零也不例外。

仅供参考的元数据,不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

查询参数
  • country
    枚举
    常量:  
    ww

    仅提供全球数据;取值不区分大小写。

    值
    • ww
  • domain
    类型: string
    最小长度:  
    1
    最大长度:  
    253
    必填
  • end_date
    类型: string
    必填
  • granularity
    枚举
    常量:  
    monthly
    值
    • monthly
  • main_domain_only
    类型: boolean
  • metrics
    类型: string
    必填

    项分隔符:,。最多 8 个分隔项。至少 1 个分隔项。

  • mtd
    类型: boolean
  • start_date
    类型: string
    必填
  • web_source
    类型: string 枚举
    值
    • desktop
    • mobile_web
    • total
响应
  • 200
    类型: object

    SimilarWeb v5 信封结构(meta + data)。

    • data
      类型: array object[]
      • average_visit_duration
        类型: number | null 格式: double

        网站平均停留时间(秒)

      • bounce_rate
        类型: number | null 格式: double

        只浏览网站单个页面的访问占比

      • date
        类型: string
      • new_users
        类型: number | null 格式: double

        网站新用户数量的估计值

      • page_views
        类型: number | null 格式: double

        网站页面浏览量的估计值

      • pages_per_visit
        类型: number | null 格式: double

        每次访问的平均页面浏览数

      • returning_users
        类型: number | null 格式: double

        网站回访用户数量的估计值

      • unique_visitors
        类型: number | null 格式: double

        网站独立访客数量的估计值(不跨设备去重)

      • visits
        类型: number | null 格式: double

        网站访问次数的估计值

    • meta
      类型: object · ResponseE0D24A93E9A2_SimilarWebMeta

      SimilarWeb v5 响应信封元数据。

      • status
        类型: string
        必填

        上游状态;调用成功时为 'success'。

      • last_updated
        类型: string

        上游可用的最新数据点日期(YYYY-MM-DD)。

      • query
        类型: object

        适用时回显分页/排序参数(limit、offset、asc、sort)。

      • request
        类型: object

        规范化的上游请求的完整回显(按接收到的参数)。

    application/json
  • 400

    无法处理该请求。请检查请求参数。

  • 401

    需要有效的 Felo API 密钥。

  • 402

    由于未满足计费要求,请求无法继续。

  • 403

    该账户无权执行此操作。

  • 429

    已达到请求或支出限额。

  • 502

    服务无法完成该请求。

  • 503

    API 或计费服务暂时不可用。

  • 504

    服务在处理请求时超时。

  • default

    错误响应;上游透传响应可能采用提供方格式

    application/json
Request Example for get/v1/beta/similarweb/website/traffic-engagement
curl 'https://openapi.felo.ai/v1/beta/similarweb/website/traffic-engagement?domain=cnn.com&end_date=2026-09&metrics=visits&start_date=2026-09' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "meta": {
    "status": "success",
    "last_updated": "2026-06-30",
    "request": {},
    "query": {}
  },
  "data": [
    {
      "date": "string",
      "visits": null,
      "bounce_rate": null,
      "average_visit_duration": null,
      "pages_per_visit": null,
      "page_views": null,
      "unique_visitors": null,
      "new_users": null,
      "returning_users": null
    }
  ]
}
Traffic & Engagement

需要帮助?