Website Analytics
Website traffic, engagement, audience, rankings and search data.
أفضل المناطق الجغرافية للموقع
الدول الأولى حسب حصة حركة نطاق لأحدث شهر متاح (data.countries، حتى 10 صفوف مع country_code وcountry_name وshare وvisits). التغطية الجغرافية عالمية (ww) وثابتة: لا يُقبل معامل country لنقطة النهاية هذه.
مرجع التسعير
- القياس: عدد النتائج المقيس.
- تقدير الطلب المرجعي: 2.25 دولار أمريكي.
- أساس تكلفة الوحدة: 0.075 دولار أمريكي.
- وحدة المورد:
similarweb_credit. - مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
- لا تحدد أسس التكلفة السعر النهائي للعميل، بما في ذلك عندما تكون صفرًا.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: stringdomainمطلوب
اسم مضيف موقع مجرّد دون scheme أو path أو port أو credentials.
- النوع: stringmonth
شهر كامل بصيغة YYYY-MM. الافتراضي هو الشهر الميلادي الكامل السابق بتوقيت UTC.
- النوع: object200
استجابة ناجحة مُطبّعة
- النوع: objectdataمطلوب
- countriesالنوع: array object[] 1…10مطلوب
- countryالنوع: string
_code مطلوب - countryالنوع: string
_name مطلوب - rankالنوع: number | nullمطلوب
- shareالنوع: number | nullمطلوب
- visitsالنوع: number | nullمطلوب
- النوع: objectmetaمطلوب
- countryتعدادثابت:wwمطلوبالقيم
- ww
- endالنوع: string
_date مطلوب - granularityثابت:monthlyمطلوب
- requestالنوع: string
_id مطلوب - retrievedالنوع: string التنسيق: date-time
_at مطلوبthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- sourceثابت:similarwebمطلوب
- startالنوع: string
_date مطلوب
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-top-geographies?domain=example.com' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"data": {
"countries": [
{
"country_code": "string",
"country_name": "string",
"rank": null,
"share": null,
"visits": null
}
]
},
"meta": {
"country": "ww",
"end_date": "string",
"granularity": "monthly",
"request_id": "string",
"retrieved_at": "2026-10-26T08:08:16.601Z",
"source": "similarweb",
"start_date": "string"
}
}