Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ Similarweb
v0.2.0-beta
OpenAPI 3.1.0

ترتيب Similarweb لأفضل المواقع

الخادم:https://openapi.felo.ai
مكتبات العملاء

Website Analytics

​

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

Website Analytics العمليات

ترتيب Similarweb لأفضل المواقع

​

يعيد ترتيب المواقع لفئة صناعية. category وlimit مطلوبان، ويجب أن تكون limit بين 1 و20. يدعم country بيانات العالمية (ww) فقط، وقيمته الافتراضية ww. يتحكم offset في الترقيم الصفحي. تحتوي الاستجابة على meta وdata.

مرجع التسعير

  • القياس: عدد النتائج المقيس.
  • تقدير الطلب المرجعي: 0.075 دولار أمريكي.
  • أساس تكلفة الوحدة: 0.075 دولار أمريكي.
  • وحدة المورد: similarweb_credit.
  • مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
  • لا تحدد أسس التكلفة السعر النهائي للعميل، بما في ذلك عندما تكون صفرًا.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

معاملات الاستعلام
  • category
    النوع: string
    أدنى طول:  
    1
    أقصى طول:  
    191
    مطلوب
  • country
    تعداد
    ثابت:  
    ww

    بيانات العالمية فقط؛ القيم غير حساسة لحالة الأحرف.

    القيم
    • ww
  • limit
    النوع: integer
    الحد الأدنى:  
    1
    الحد الأقصى:  
    20
    مطلوب

    Integer numbers.

  • offset
    النوع: integer
    الحد الأدنى:  
    0
    الحد الأقصى:  
    100000

    Integer numbers.

الاستجابات
  • 200
    النوع: object

    غلاف SimilarWeb v5 (meta + data).

    • data
      النوع: array object[]
      • domain
        النوع: string
      • rank
        النوع: integer

        Integer numbers.

    • meta
      النوع: object · ResponseC6C9032778Bd_SimilarWebMeta

      بيانات وصفية لغلاف استجابة SimilarWeb v5.

      • status
        النوع: string
        مطلوب

        حالة المصدر؛ 'success' عند نجاح الاستدعاء.

      • last_updated
        النوع: string

        تاريخ أحدث نقطة بيانات متاحة لدى المصدر (YYYY-MM-DD).

      • query
        النوع: object

        تكرار معاملات ترقيم الصفحات/الفرز عند الاقتضاء (limit, offset, asc, sort).

      • request
        النوع: object

        تكرار كامل للطلب المُطبَّع الوارد من المصدر (المعلمات كما وردت).

    application/json
  • 400

    تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

  • 401

    مطلوب مفتاح API صالح من Felo.

  • 402

    لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

  • 403

    الحساب غير مصرّح له بهذه العملية.

  • 429

    تم بلوغ حد الطلبات أو حد الإنفاق.

  • 502

    تعذّر على الخدمة إكمال الطلب.

  • 503

    خدمة API أو الفوترة غير متاحة مؤقتًا.

  • 504

    انتهت مهلة الخدمة أثناء معالجة الطلب.

  • default

    استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

    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