Website Analytics
Website traffic, engagement, audience, rankings and search data.
بازیگران SERP - تجمیع‌شده
بازیگران SERP - تجمیع‌شده. پاسخ از پاکت SimilarWeb v5 (meta + data) پیروی می‌کند.
مرجع قیمت‌گذاری
- اندازه‌گیری: تعداد نتایج اندازه‌گیری‌شده.
- برآورد درخواست مرجع: 0.075 دلار آمریکا.
- مبنای هزینه واحد: 0.075 دلار آمریکا.
- واحد منبع:
similarweb_credit. - ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
- مبناهای هزینه، قیمت نهایی مشتری را تعیین نمی‌کنند، از جمله وقتی صفر باشند.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- فهرست مقادیرcountryمقدار ثابت:ww
فقط داده جهانی؛ مقادیر به بزرگی و کوچکی حروف حساس نیستند.
مقادیر- ww
- نوع: stringend
_date الزامی - فهرست مقادیرgranularityمقدار ثابت:monthlyمقادیر
- monthly
- نوع: stringkeywordsالزامی
جداکننده آیتم:
,. حداکثر 1 آیتم جداشده. حداقل 1 آیتم جداشده. - نوع: integerlimitحداقل:1حداکثر:20الزامی
Integer numbers.
- نوع: integeroffsetحداقل:0حداکثر:100000
Integer numbers.
- نوع: stringstart
_date الزامی
- نوع: object200
پاکت SimilarWeb v5 (meta + data).
- نوع: array object[]data
- clicksنوع: number | null قالب: double
مجموع کلیک‌هایی که دامنه برای کلیدواژه تحلیل‌شده دریافت می‌کند
- domainنوع: string | null
دامنه وب‌سایت بدون 'www.' (مثلاً 'example.com')
- serpنوع: array string[] | string
_features - siteنوع: string | null
زیردامنه وب‌سایت بدون 'www.' (مثلاً 'developer.example.com')
- topنوع: string | null
_url نشانی URL سایتی با بالاترین موقعیت ارگانیک که برای کلیدواژه تحلیل‌شده رتبه می‌گیرد
- topنوع: integer | null قالب: int32
_url _position بالاترین موقعیت ترکیبی جدید top_url در بازه زمانی انتخاب‌شده
- trafficنوع: number | null قالب: double
_share سهم ترافیک به وب‌سایت
- نوع: object · Response62E957Bfd704_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/search/serp-players-aggregated?end_date=2026-09&keywords=example&limit=1&start_date=2026-09' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"meta": {
"status": "success",
"last_updated": "2026-06-30",
"request": {},
"query": {}
},
"data": [
{
"site": null,
"domain": null,
"clicks": null,
"traffic_share": null,
"serp_features": [
"string"
],
"top_url_position": null,
"top_url": null
}
]
}