Website Analytics
Website traffic, engagement, audience, rankings and search data.
روند ترافیک وب‌سایت
سری زمانی ماهانه ترافیک برای یک دامنه در بازه اخیر موجود (data.points، یک ورودی برای هر ماه). بازه به‌صورت خودکار انتخاب و در meta.start_date / meta.end_date بازتاب داده می‌شود.
مرجع قیمت‌گذاری
- اندازه‌گیری: واحدهای منابع طرح.
- برآورد درخواست مرجع: 0.45 دلار آمریکا.
- مبنای هزینه واحد: 0.075 دلار آمریکا.
- واحد منبع:
similarweb_credit. - ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
- مبناهای هزینه، قیمت نهایی مشتری را تعیین نمی‌کنند، از جمله وقتی صفر باشند.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- فهرست مقادیرcountryمقدار ثابت:ww
فقط داده جهانی؛ مقادیر به بزرگی و کوچکی حروف حساس نیستند.
مقادیر- ww
- نوع: stringdomainالزامی
نام میزبان وب‌سایت به‌تنهایی، بدون scheme، path، port یا credentials.
- نوع: stringend
_date آخرین ماه کامل UTC به قالب YYYY-MM، شامل.
- نوع: stringmetrics
یک تا چهار معیار پشتیبانی‌شده Traffic & Engagement. جداکننده آیتم:
,. آیتم‌های مجاز: average_visit_duration، bounce_rate، new_users، page_views، pages_per_visit، returning_users، unique_visitors، visits. حداکثر 4 آیتم جداشده. - نوع: stringstart
_date اولین ماه به قالب YYYY-MM، شامل؛ همراه با end_date ارائه دهید.
- نوع: object200
پاسخ موفق نرمال‌شده
- نوع: objectdataالزامی
- 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نوع: number | null
_visit _duration - bounceنوع: number | null
_rate - newنوع: number | null
_users - pageنوع: number | null
_views - pagesنوع: number | null
_per _visit - returningنوع: number | null
_users - uniqueنوع: number | null
_visitors - 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-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.601Z",
"source": "similarweb",
"start_date": "string"
}
}