v0.2.0-beta

OpenAPI 3.1.0

网站流量趋势

Felo API Support

MIT

服务器

https://openapi.felo.ai

客户端库

Shell Curl

Website Analytics

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

Website Analytics 操作

get/v1/beta/similarweb/website-traffic-trend

网站流量趋势

域名在最近可用窗口内的月度流量时间序列（data.points，每月一个条目）。该窗口会自动选取，并在 meta.start_date / meta.end_date 中回显。

计费参考

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

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

查询参数

country
枚举
常量:
ww

仅提供全球数据；取值不区分大小写。
值
- ww
domain
类型: string
必填

不含协议、路径、端口或凭据的裸网站主机名。
end_date
类型: string

以 YYYY-MM 表示的最后一个完整 UTC 月份（含该月）。
metrics
类型: string

一至四个受支持的流量与互动指标。条目分隔符：,。允许的条目：average_visit_duration、bounce_rate、new_users、page_views、pages_per_visit、returning_users、unique_visitors、visits。最多 4 个分隔条目。
start_date
类型: string

以 YYYY-MM 表示的首个月份（含该月）；需与 end_date 一起提供。

响应

200
类型: object

规范化后的成功响应
data
类型: object
必填
domain
类型: string
必填
metrics
类型: array string[] 1…4 唯一!枚举
必填
值
average_visit_duration
bounce_rate
new_users
page_views
pages_per_visit
returning_users
unique_visitors
visits
points
类型: array object[] 1…
必填
month
类型: string
必填
values
类型: object
必填
average_visit_duration
类型: number | null
bounce_rate
类型: number | null
new_users
类型: number | null
page_views
类型: number | null
pages_per_visit
类型: number | null
returning_users
类型: number | null
unique_visitors
类型: number | null
visits
类型: number | null
meta
类型: object
必填
country
枚举
常量:
ww
必填
值
ww
end_date
类型: string
必填
granularity
常量:
monthly
必填
request_id
类型: string
必填
retrieved_at
类型: string 格式: date-time
必填

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

source
常量:
similarweb
必填
start_date
类型: string
必填
application/json
400

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

需要有效的 Felo API 密钥。
402

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

该账户无权执行此操作。
429

已达到请求或支出限额。
502

服务无法完成该请求。
503

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

服务在处理请求时超时。
default

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

application/json

get/v1/beta/similarweb/website-traffic-trend

curl 'https://openapi.felo.ai/v1/beta/similarweb/website-traffic-trend?domain=example.com' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

显示 Schema

{
  "data": {
    "domain": "string",
    "metrics": [
      "average_visit_duration"
    ],
    "points": [
      {
        "month": "string",
        "values": {
          "average_visit_duration": null,
          "bounce_rate": null,
          "new_users": null,
          "page_views": null,
          "pages_per_visit": null,
          "returning_users": null,
          "unique_visitors": null,
          "visits": null
        }
      }
    ]
  },
  "meta": {
    "country": "ww",
    "end_date": "string",
    "granularity": "monthly",
    "request_id": "string",
    "retrieved_at": "2026-10-26T08:08:16.678Z",
    "source": "similarweb",
    "start_date": "string"
  }
}

规范化后的成功响应

网站流量趋势

身份验证Required

Website Analytics

网站流量趋势

计费参考

需要帮助？