Website Analytics
Website traffic, engagement, audience, rankings and search data.
SimilarSites
SimilarSites. پاسخ از پاکت SimilarWeb v5 (meta + data) پیروی می‌کند. بازه تاریخ (محدودیت SimilarWeb در بالادست): start_date و end_date باید دقیقاً 3 ماه متوالی را پوشش دهند — بازه 1 یا 2 ماهه با خطای بالادست 120 ('must span exactly 3 month(s)') رد می‌شود. این بازه باید همچنین جدیدترین پنجره پشتیبانی‌شده SimilarWeb باشد که هر ماه جلو می‌رود؛ بازه قدیمی‌تر یا خارج از محدوده با خطای 101 ('Dates not in range') رد می‌شود. در عمل، سه ماه کامل اخیر را درخواست کنید (مثلاً اگر آخرین ماه منتشرشده 2026-07 است، از start_date=2026-05 و end_date=2026-07 استفاده کنید). برای خواندن محدوده دقیق پشتیبانی‌شده در حال حاضر، نقطه پایانی /describe مربوط به SimilarWeb را برای این API فراخوانی کنید.
مرجع قیمت‌گذاری
- اندازه‌گیری: تعداد نتایج اندازه‌گیری‌شده.
- برآورد درخواست مرجع: 0.375 دلار آمریکا.
- مبنای هزینه واحد: 0.075 دلار آمریکا.
- واحد منبع:
similarweb_credit. - ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
- مبناهای هزینه، قیمت نهایی مشتری را تعیین نمی‌کنند، از جمله وقتی صفر باشند.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- فهرست مقادیرcountryمقدار ثابت:ww
فقط داده جهانی؛ مقادیر به بزرگی و کوچکی حروف حساس نیستند.
مقادیر- ww
- نوع: stringdomainحداقل طول:1حداکثر طول:253الزامی
- نوع: stringend
_date الزامی - فهرست مقادیرgranularityمقدار ثابت:monthlyمقادیر
- monthly
- نوع: integerlimitحداقل:1حداکثر:20الزامی
Integer numbers.
- نوع: booleanmain
_domain _only - نوع: integeroffsetحداقل:0حداکثر:100000
Integer numbers.
- نوع: stringstart
_date الزامی - نوع: stringtraffic
_source - نوع: string فهرست مقادیرweb
_source مقادیر- desktop
- mobile
_web - total
- نوع: object200
پاکت SimilarWeb v5 (meta + data).
- نوع: array object[]data
- affinityنوع: number
- categoryنوع: string
- domainنوع: string
- hasنوع: boolean
_adsense - rankنوع: integer
Integer numbers.
- نوع: object · Response7B51F63Afd06_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/similar-sites?domain=cnn.com&end_date=2026-09&limit=1&start_date=2026-07' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"meta": {
"query": {
"limit": 5,
"offset": 0,
"asc": null,
"sort": null
},
"request": {
"format": "json",
"domain": "cnn.com",
"granularity": "monthly",
"start_date": "2026-05-01",
"end_date": "2026-07-31",
"metrics": [
"rank",
"affinity",
"has_adsense"
],
"category": null
},
"status": "success",
"last_updated": "2026-07-31"
},
"data": [
{
"domain": "bbc.com",
"category": "News_and_Media",
"rank": 95,
"affinity": 1,
"has_adsense": true
}
]
}