Felo API PlatformFelo API Platform
Tất cả endpoint của Similarweb
v0.2.0-beta
OpenAPI 3.1.0

Xu hướng lưu lượng website

Máy chủ:https://openapi.felo.ai
Thư viện client

Website Analytics

​

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

Xu hướng lưu lượng website

​

Chuỗi thời gian lưu lượng theo tháng của một tên miền trong khoảng gần nhất có dữ liệu (data.points, một mục cho mỗi tháng). Khoảng thời gian được chọn tự động và được phản chiếu trong meta.start_date / meta.end_date.

Tham chiếu giá

  • Đo lường: Đơn vị tài nguyên theo gói.
  • Ước tính tham chiếu cho mỗi yêu cầu: USD 0.45.
  • Cơ sở chi phí đơn vị: USD 0.075.
  • Đơn vị tài nguyên: similarweb_credit.
  • Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.
  • Cơ sở chi phí không xác lập giá cuối cùng cho khách hàng, kể cả khi bằng 0.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

Tham số truy vấn
  • country
    enum
    const:  
    ww

    Chỉ dữ liệu toàn cầu; giá trị không phân biệt chữ hoa chữ thường.

    giá trị
    • ww
  • domain
    Kiểu: string
    bắt buộc

    Tên máy chủ website trần, không có scheme, path, cổng hay thông tin xác thực.

  • end_date
    Kiểu: string

    Tháng UTC đầy đủ cuối cùng (bao gồm) theo định dạng YYYY-MM.

  • metrics
    Kiểu: string

    Từ một đến bốn chỉ số Traffic & Engagement được hỗ trợ. Dấu phân cách mục: ,. Các mục được phép: average_visit_duration, bounce_rate, new_users, page_views, pages_per_visit, returning_users, unique_visitors, visits. Tối đa 4 mục được phân tách.

  • start_date
    Kiểu: string

    Tháng đầu tiên (bao gồm) theo định dạng YYYY-MM; cung cấp cùng với end_date.

Phản hồi
  • 200
    Kiểu: object

    Phản hồi thành công đã chuẩn hóa

    • data
      Kiểu: object
      bắt buộc
      • domain
        Kiểu: string
        bắt buộc
      • metrics
        Kiểu: array string[] 1…4 duy nhất!enum
        bắt buộc
        giá trị
        • average_visit_duration
        • bounce_rate
        • new_users
        • page_views
        • pages_per_visit
        • returning_users
        • unique_visitors
        • visits
      • points
        Kiểu: array object[] 1…
        bắt buộc
        • month
          Kiểu: string
          bắt buộc
        • values
          Kiểu: object
          bắt buộc
          • average_visit_duration
            Kiểu: number | null
          • bounce_rate
            Kiểu: number | null
          • new_users
            Kiểu: number | null
          • page_views
            Kiểu: number | null
          • pages_per_visit
            Kiểu: number | null
          • returning_users
            Kiểu: number | null
          • unique_visitors
            Kiểu: number | null
          • visits
            Kiểu: number | null
    • meta
      Kiểu: object
      bắt buộc
      • country
        enum
        const:  
        ww
        bắt buộc
        giá trị
        • ww
      • end_date
        Kiểu: string
        bắt buộc
      • granularity
        const:  
        monthly
        bắt buộc
      • request_id
        Kiểu: string
        bắt buộc
      • retrieved_at
        Kiểu: string Định dạng: date-time
        bắt buộc

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

      • source
        const:  
        similarweb
        bắt buộc
      • start_date
        Kiểu: string
        bắt buộc
    application/json
  • 400

    Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

  • 401

    Cần có khóa API Felo hợp lệ.

  • 402

    Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

  • 403

    Tài khoản không được phép thực hiện thao tác này.

  • 429

    Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

  • 502

    Dịch vụ không thể hoàn tất yêu cầu.

  • 503

    API hoặc dịch vụ thanh toán tạm thời không khả dụng.

  • 504

    Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

  • default

    Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

    application/json
Request Example for 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'
{
  "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.607Z",
    "source": "similarweb",
    "start_date": "string"
  }
}
Website Traffic Trend