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

Xếp hạng trang web hàng đầu Similarweb

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

Website Analytics

​

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

Xếp hạng trang web hàng đầu Similarweb

​

Trả về xếp hạng website cho một danh mục ngành. category và limit là bắt buộc. limit phải nằm trong khoảng 1 đến 20. country chỉ hỗ trợ dữ liệu toàn cầu (ww) và mặc định là ww. offset điều khiển phân trang. Phản hồi chứa meta và data.

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 0.075.
  • 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
  • category
    Kiểu: string
    độ dài tối thiểu:  
    1
    độ dài tối đa:  
    191
    bắt buộc
  • 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
  • limit
    Kiểu: integer
    tối thiểu:  
    1
    tối đa:  
    20
    bắt buộc

    Integer numbers.

  • offset
    Kiểu: integer
    tối thiểu:  
    0
    tối đa:  
    100000

    Integer numbers.

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

    Phong bì SimilarWeb v5 (meta + data).

    • data
      Kiểu: array object[]
      • domain
        Kiểu: string
      • rank
        Kiểu: integer

        Integer numbers.

    • meta
      Kiểu: object · ResponseC6C9032778Bd_SimilarWebMeta

      Siêu dữ liệu envelope phản hồi SimilarWeb v5.

      • status
        Kiểu: string
        bắt buộc

        Trạng thái thượng nguồn; 'success' khi gọi thành công.

      • last_updated
        Kiểu: string

        Ngày của điểm dữ liệu gần nhất có sẵn ở thượng nguồn (YYYY-MM-DD).

      • query
        Kiểu: object

        Phản hồi phân trang/sắp xếp khi áp dụng (limit, offset, asc, sort).

      • request
        Kiểu: object

        Phản hồi đầy đủ của yêu cầu thượng nguồn đã chuẩn hóa (tham số như đã nhận).

    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-sites-ranking
curl --request GET https://openapi.felo.ai/v1/beta/similarweb/website/top-sites-ranking \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --get \
  --data-urlencode category=Finance \
  --data-urlencode limit=5 \
  --data-urlencode country=ww \
  --data-urlencode offset=0
{
  "meta": {
    "query": {
      "limit": 5,
      "offset": 0
    },
    "request": {
      "category": "Finance",
      "country": "ww"
    },
    "status": "success",
    "last_updated": "2026-09-01"
  },
  "data": [
    {
      "domain": "example.com",
      "rank": 1
    }
  ]
}
Similarweb Top Sites Ranking