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

Địa lý hàng đầu của website

Felo API Support
MIT
Máy chủ:https://openapi.felo.ai
Thư viện client
Shell Curl

Website Analytics

​

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

Website Analytics Thao tác

Địa lý hàng đầu của website

​

Các quốc gia hàng đầu theo tỷ trọng lưu lượng của một tên miền trong tháng gần nhất có dữ liệu (data.countries, tối đa 10 hàng với country_code, country_name, share và visits). Phạm vi địa lý là toàn cầu (ww) và cố định: endpoint này không chấp nhận tham số country.

Tham chiếu giá

  • Đo lường: Số lượng kết quả được đo lường.
  • Ước tính tham chiếu cho mỗi yêu cầu: USD 2.25.
  • 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
  • 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.

  • month
    Kiểu: string

    Tháng đầy đủ theo định dạng YYYY-MM. Mặc định là tháng UTC đầy đủ trước đó.

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
      • countries
        Kiểu: array object[] 1…10
        bắt buộc
        • country_code
          Kiểu: string
          bắt buộc
        • country_name
          Kiểu: string
          bắt buộc
        • rank
          Kiểu: number | null
          bắt buộc
        • share
          Kiểu: number | null
          bắt buộc
        • visits
          Kiểu: number | null
          bắt buộc
    • 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-top-geographies
curl 'https://openapi.felo.ai/v1/beta/similarweb/website-top-geographies?domain=example.com' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": {
    "countries": [
      {
        "country_code": "string",
        "country_name": "string",
        "rank": null,
        "share": 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"
  }
}

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

Website Top Geographies