Felo API PlatformFelo API Platform
همه endpointهای Similarweb
v0.2.0-beta
OpenAPI 3.1.0

عکس فوری ترافیک وب‌سایت

سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت

Website Analytics

​

Website traffic, engagement, audience, rankings and search data.

عکس فوری ترافیک وب‌سایت

​

عکس فوری ترافیک آخرین ماه برای یک دامنه: بازدیدها به‌همراه معیارهای اصلی تعامل (میانگین مدت بازدید، نرخ پرش، صفحات به ازای هر بازدید) در یک شیء. جدیدترین ماه موجود به‌صورت خودکار انتخاب و در meta.start_date / meta.end_date بازتاب داده می‌شود.

مرجع قیمت‌گذاری

  • اندازه‌گیری: واحدهای منابع طرح.
  • برآورد درخواست مرجع: 0.3 دلار آمریکا.
  • مبنای هزینه واحد: 0.075 دلار آمریکا.
  • واحد منبع: similarweb_credit.
  • ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
  • مبناهای هزینه، قیمت نهایی مشتری را تعیین نمی‌کنند، از جمله وقتی صفر باشند.

فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

پارامترهای پرس‌وجو
  • country
    فهرست مقادیر
    مقدار ثابت:  
    ww

    فقط داده جهانی؛ مقادیر به بزرگی و کوچکی حروف حساس نیستند.

    مقادیر
    • ww
  • domain
    نوع: string
    الزامی

    نام میزبان وب‌سایت به‌تنهایی، بدون scheme، path، port یا credentials.

  • month
    نوع: string

    ماه کامل به قالب YYYY-MM. پیش‌فرض ماه کامل قبلی به وقت UTC است.

پاسخ‌ها
  • 200
    نوع: object

    پاسخ موفق نرمال‌شده

    • data
      نوع: object
      الزامی
      • domain
        نوع: string
        الزامی
      • metrics
        نوع: object
        الزامی
        • average_visit_duration
          نوع: number | null
          الزامی
        • bounce_rate
          نوع: number | null
          الزامی
        • pages_per_visit
          نوع: number | null
          الزامی
        • visits
          نوع: number | null
          الزامی
      • month
        نوع: string
        الزامی
    • meta
      نوع: object
      الزامی
      • country
        فهرست مقادیر
        مقدار ثابت:  
        ww
        الزامی
        مقادیر
        • ww
      • end_date
        نوع: string
        الزامی
      • granularity
        مقدار ثابت:  
        monthly
        الزامی
      • request_id
        نوع: string
        الزامی
      • retrieved_at
        نوع: string قالب: date-time
        الزامی

        the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

      • source
        مقدار ثابت:  
        similarweb
        الزامی
      • start_date
        نوع: string
        الزامی
    application/json
  • 400

    درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.

  • 401

    یک کلید API معتبر Felo لازم است.

  • 402

    درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.

  • 403

    حساب مجاز به انجام این عملیات نیست.

  • 429

    به سقف درخواست یا هزینه رسیده‌اید.

  • 502

    سرویس نتوانست درخواست را کامل کند.

  • 503

    سرویس API یا صورت‌حساب موقتاً در دسترس نیست.

  • 504

    سرویس هنگام پردازش درخواست به پایان مهلت رسید.

  • default

    پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند

    application/json
Request Example for get/v1/beta/similarweb/website-traffic-snapshot
curl 'https://openapi.felo.ai/v1/beta/similarweb/website-traffic-snapshot?domain=example.com' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "data": {
    "domain": "string",
    "metrics": {
      "average_visit_duration": null,
      "bounce_rate": null,
      "pages_per_visit": null,
      "visits": null
    },
    "month": "string"
  },
  "meta": {
    "country": "ww",
    "end_date": "string",
    "granularity": "monthly",
    "request_id": "string",
    "retrieved_at": "2026-10-26T08:08:16.678Z",
    "source": "similarweb",
    "start_date": "string"
  }
}
Website Traffic Snapshot