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

Trang tương tự

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

Website Analytics

​

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

Trang tương tự

​

Trang tương tự. Phản hồi tuân theo phong bì SimilarWeb v5 (meta + data). Khung ngày (ràng buộc từ SimilarWeb phía thượng nguồn): start_date và end_date phải trải đúng 3 tháng liên tiếp — khoảng 1 hoặc 2 tháng sẽ bị từ chối với lỗi thượng nguồn 120 ('must span exactly 3 month(s)'). Khoảng đó cũng phải là khung được hỗ trợ gần nhất của SimilarWeb, khung này tiến lên mỗi tháng; khoảng cũ hơn hoặc ngoài phạm vi sẽ bị từ chối với lỗi 101 ('Dates not in range'). Trên thực tế, hãy yêu cầu ba tháng đã hoàn tất gần nhất (ví dụ: nếu tháng được công bố mới nhất là 2026-07, dùng start_date=2026-05 và end_date=2026-07). Để đọc chính xác phạm vi hiện được hỗ trợ, hãy gọi endpoint /describe của SimilarWeb cho API này.

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.375.
  • 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
    độ dài tối thiểu:  
    1
    độ dài tối đa:  
    253
    bắt buộc
  • end_date
    Kiểu: string
    bắt buộc
  • granularity
    enum
    const:  
    monthly
    giá trị
    • monthly
  • limit
    Kiểu: integer
    tối thiểu:  
    1
    tối đa:  
    20
    bắt buộc

    Integer numbers.

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

    Integer numbers.

  • start_date
    Kiểu: string
    bắt buộc
  • traffic_source
    Kiểu: string
  • web_source
    Kiểu: string enum
    giá trị
    • desktop
    • mobile_web
    • total
Phản hồi
  • 200
    Kiểu: object

    Phong bì SimilarWeb v5 (meta + data).

    • data
      Kiểu: array object[]
      • affinity
        Kiểu: number
      • category
        Kiểu: string
      • domain
        Kiểu: string
      • has_adsense
        Kiểu: boolean
      • rank
        Kiểu: integer

        Integer numbers.

    • meta
      Kiểu: object · Response7B51F63Afd06_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/similar-sites
curl 'https://openapi.felo.ai/v1/beta/similarweb/website/similar-sites?domain=cnn.com&end_date=2026-09&limit=1&start_date=2026-07' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "meta": {
    "query": {
      "limit": 5,
      "offset": 0,
      "asc": null,
      "sort": null
    },
    "request": {
      "format": "json",
      "domain": "cnn.com",
      "granularity": "monthly",
      "start_date": "2026-05-01",
      "end_date": "2026-07-31",
      "metrics": [
        "rank",
        "affinity",
        "has_adsense"
      ],
      "category": null
    },
    "status": "success",
    "last_updated": "2026-07-31"
  },
  "data": [
    {
      "domain": "bbc.com",
      "category": "News_and_Media",
      "rank": 95,
      "affinity": 1,
      "has_adsense": true
    }
  ]
}
SimilarSites