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.607Z",
"source": "similarweb",
"start_date": "string"
}
}