Website Analytics
Website traffic, engagement, audience, rankings and search data.
SimilarSites
SimilarSites. تتبع الاستجابة غلاف SimilarWeb v5 (meta + data). النطاق الزمني (قيد من SimilarWeb في المنبع): يجب أن يمتد start_date وend_date بالضبط 3 أشهر متتالية — تُرفض الفترة من شهر أو شهرين بخطأ المنبع 120 ('must span exactly 3 month(s)'). ويجب أن تكون هذه الفترة أيضًا أحدث نافذة يدعمها SimilarWeb، وهي تتقدّم شهرًا كل شهر؛ وتُرفض الفترة الأقدم أو الخارجة عن النطاق بخطأ 101 ('Dates not in range'). عمليًا، اطلب أحدث ثلاثة أشهر مكتملة (مثلًا إذا كان آخر شهر منشور هو 2026-07، فاستخدم start_date=2026-05 وend_date=2026-07). لمعرفة النطاق المدعوم حاليًا بدقة، استدعِ نقطة النهاية /describe الخاصة بـ SimilarWeb لهذه الواجهة.
مرجع التسعير
- القياس: عدد النتائج المقيس.
- تقدير الطلب المرجعي: 0.375 دولار أمريكي.
- أساس تكلفة الوحدة: 0.075 دولار أمريكي.
- وحدة المورد:
similarweb_credit. - مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
- لا تحدد أسس التكلفة السعر النهائي للعميل، بما في ذلك عندما تكون صفرًا.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- تعدادcountryثابت:ww
بيانات العالمية فقط؛ القيم غير حساسة لحالة الأحرف.
القيم- ww
- النوع: stringdomainأدنى طول:1أقصى طول:253مطلوب
- النوع: stringend
_date مطلوب - تعدادgranularityثابت:monthlyالقيم
- monthly
- النوع: integerlimitالحد الأدنى:1الحد الأقصى:20مطلوب
Integer numbers.
- النوع: booleanmain
_domain _only - النوع: integeroffsetالحد الأدنى:0الحد الأقصى:100000
Integer numbers.
- النوع: stringstart
_date مطلوب - النوع: stringtraffic
_source - النوع: string تعدادweb
_source القيم- desktop
- mobile
_web - total
- النوع: object200
غلاف SimilarWeb v5 (meta + data).
- النوع: array object[]data
- affinityالنوع: number
- categoryالنوع: string
- domainالنوع: string
- hasالنوع: boolean
_adsense - rankالنوع: integer
Integer numbers.
- النوع: object · Response7B51F63Afd06_SimilarWebMetameta
بيانات وصفية لغلاف استجابة SimilarWeb v5.
- statusالنوع: stringمطلوب
حالة المصدر؛ 'success' عند نجاح الاستدعاء.
- lastالنوع: string
_updated تاريخ أحدث نقطة بيانات متاحة لدى المصدر (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
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
}
]
}