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

اتجاه حركة مرور الموقع

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

Website Analytics

​

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

Website Analytics العمليات

اتجاه حركة مرور الموقع

​

سلسلة زمنية شهرية لحركة مرور نطاق خلال النافذة الحديثة المتاحة (data.points، إدخال واحد لكل شهر). تُختار النافذة تلقائيًا وتُعاد في meta.start_date / meta.end_date.

مرجع التسعير

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

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

معاملات الاستعلام
  • country
    تعداد
    ثابت:  
    ww

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

    القيم
    • ww
  • domain
    النوع: string
    مطلوب

    اسم مضيف موقع مجرّد دون scheme أو path أو port أو credentials.

  • end_date
    النوع: string

    آخر شهر ميلادي كامل بتوقيت UTC بصيغة YYYY-MM، شاملًا.

  • metrics
    النوع: string

    من مقياس إلى أربعة مقاييس مدعومة لحركة المرور والتفاعل. فاصل العناصر: ,. العناصر المسموح بها: average_visit_duration، bounce_rate، new_users، page_views، pages_per_visit، returning_users، unique_visitors، visits. 4 عناصر مفصولة كحد أقصى.

  • start_date
    النوع: string

    أول شهر بصيغة YYYY-MM، شاملًا؛ يُقدَّم مع end_date.

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

    استجابة ناجحة مُطبّعة

    • data
      النوع: object
      مطلوب
      • domain
        النوع: string
        مطلوب
      • metrics
        النوع: array string[] 1…4 فريد!تعداد
        مطلوب
        القيم
        • average_visit_duration
        • bounce_rate
        • new_users
        • page_views
        • pages_per_visit
        • returning_users
        • unique_visitors
        • visits
      • points
        النوع: array object[] 1…
        مطلوب
        • month
          النوع: string
          مطلوب
        • values
          النوع: object
          مطلوب
          • average_visit_duration
            النوع: number | null
          • bounce_rate
            النوع: number | null
          • new_users
            النوع: number | null
          • page_views
            النوع: number | null
          • pages_per_visit
            النوع: number | null
          • returning_users
            النوع: number | null
          • unique_visitors
            النوع: number | null
          • visits
            النوع: number | null
    • meta
      النوع: object
      مطلوب
      • country
        تعداد
        ثابت:  
        ww
        مطلوب
        القيم
        • ww
      • end_date
        النوع: string
        مطلوب
      • granularity
        ثابت:  
        monthly
        مطلوب
      • request_id
        النوع: string
        مطلوب
      • retrieved_at
        النوع: string التنسيق: date-time
        مطلوب

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

      • source
        ثابت:  
        similarweb
        مطلوب
      • start_date
        النوع: string
        مطلوب
    application/json
  • 400

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

  • 401

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

  • 402

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

  • 403

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

  • 429

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

  • 502

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

  • 503

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

  • 504

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

  • default

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

    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