Website Analytics
Website traffic, engagement, audience, rankings and search data.
ترافیک و تعامل
ترافیک و تعامل. پاسخ از پاکت SimilarWeb v5 (meta + data) پیروی می‌کند. محدودیت تاریخ: بازه start_date-end_date باید بین 1 تا 120 پنجره ماهانه را پوشش دهد.
مرجع قیمت‌گذاری
- اندازه‌گیری: واحدهای منابع طرح.
- برآورد درخواست مرجع: 0.075 دلار آمریکا.
- مبنای هزینه واحد: 0.075 دلار آمریکا.
- واحد منبع:
similarweb_credit. - ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
- مبناهای هزینه، قیمت نهایی مشتری را تعیین نمی‌کنند، از جمله وقتی صفر باشند.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- فهرست مقادیرcountryمقدار ثابت:ww
فقط داده جهانی؛ مقادیر به بزرگی و کوچکی حروف حساس نیستند.
مقادیر- ww
- نوع: stringdomainحداقل طول:1حداکثر طول:253الزامی
- نوع: stringend
_date الزامی - فهرست مقادیرgranularityمقدار ثابت:monthlyمقادیر
- monthly
- نوع: booleanmain
_domain _only - نوع: stringmetricsالزامی
جداکننده آیتم:
,. حداکثر 8 آیتم جداشده. حداقل 1 آیتم جداشده. - نوع: booleanmtd
- نوع: stringstart
_date الزامی - نوع: string فهرست مقادیرweb
_source مقادیر- desktop
- mobile
_web - total
- نوع: object200
پاکت SimilarWeb v5 (meta + data).
- نوع: array object[]data
- averageنوع: number | null قالب: double
_visit _duration میانگین زمان حضور در وب‌سایت (به ثانیه)
- bounceنوع: number | null قالب: double
_rate درصد بازدیدهایی که فقط یک صفحه از وب‌سایت را می‌بینند
- dateنوع: string
- newنوع: number | null قالب: double
_users تعداد برآوردی کاربران جدید وب‌سایت
- pageنوع: number | null قالب: double
_views تعداد برآوردی صفحات دیده‌شده در وب‌سایت
- pagesنوع: number | null قالب: double
_per _visit میانگین تعداد صفحات دیده‌شده در هر بازدید
- returningنوع: number | null قالب: double
_users تعداد برآوردی کاربران بازگشتی به وب‌سایت
- uniqueنوع: number | null قالب: double
_visitors تعداد برآوردی بازدیدکنندگان یکتا (بدون حذف تکراری بین دستگاه‌ها) از وب‌سایت
- visitsنوع: number | null قالب: double
تعداد برآوردی بازدیدهای وب‌سایت
- نوع: object · ResponseE0D24A93E9A2_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/traffic-engagement?domain=cnn.com&end_date=2026-09&metrics=visits&start_date=2026-09' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"meta": {
"status": "success",
"last_updated": "2026-06-30",
"request": {},
"query": {}
},
"data": [
{
"date": "string",
"visits": null,
"bounce_rate": null,
"average_visit_duration": null,
"pages_per_visit": null,
"page_views": null,
"unique_visitors": null,
"new_users": null,
"returning_users": null
}
]
}