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.

کلیدواژه‌های وب‌سایت

​

کلیدواژه‌های وب‌سایت. پاسخ از پاکت SimilarWeb v5 (meta + data) پیروی می‌کند. محدودیت تاریخ: بازه start_date-end_date باید بین 1 تا 3 سطل ماهانه را پوشش دهد.

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

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

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

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

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

    مقادیر
    • ww
  • domain
    نوع: string
    حداقل طول:  
    1
    حداکثر طول:  
    2048
    الزامی
  • end_date
    نوع: string
    الزامی
  • format
    فهرست مقادیر
    مقدار ثابت:  
    json
    مقادیر
    • json
  • granularity
    فهرست مقادیر
    مقدار ثابت:  
    monthly
    الزامی
    مقادیر
    • monthly
  • limit
    نوع: integer
    حداقل:  
    1
    حداکثر:  
    20
    الزامی

    Integer numbers.

  • main_domain_only
    نوع: boolean
  • start_date
    نوع: string
    الزامی
  • web_source
    فهرست مقادیر
    مقدار ثابت:  
    total
    مقادیر
    • total
پاسخ‌ها
  • 200
    نوع: object

    پاکت SimilarWeb v5 (meta + data).

    • data
      نوع: array object[]
      • clicks
        نوع: number | null قالب: double

        تعداد کلیک‌های جستجوی کلیدواژه به وب‌سایت

      • competition
        نوع: integer | null قالب: int32

        سطح رقابت برای قرارگیری تبلیغ در کلیدواژه.

      • keyword
        نوع: string | null

        یک کلیدواژه یا نام یک گروه کلیدواژه برای تحلیل

      • position
        نوع: integer | null قالب: int32

        جدیدترین موقعیت جهانی کلیدواژه در بازه زمانی انتخاب‌شده. برای کشور 'world' در دسترس نیست.

      • primary_intent
        نوع: string | null

        برآوردی از اینکه کاربران جستجوکننده این کلیدواژه‌ها دنبال چه چیزی هستند.

      • secondary_intent
        نوع: string | null
      • serp_features
        نوع: array string[] | string
      • top_url
        نوع: string | null

        نشانی URL سایتی با بالاترین موقعیت ارگانیک که برای کلیدواژه تحلیل‌شده رتبه می‌گیرد

      • traffic_share
        نوع: number | null قالب: double

        سهم ترافیک به وب‌سایت

      • url_count
        نوع: integer | null قالب: int32

        تعداد URLها برای کلیدواژه

    • meta
      نوع: object · ResponseF53Baa954733_SimilarWebMeta

      فراداده پاکت پاسخ SimilarWeb v5.

      • status
        نوع: string
        الزامی

        وضعیت بالادست؛ 'success' در فراخوانی موفق.

      • last_updated
        نوع: string

        تاریخ جدیدترین نقطه داده موجود در بالادست (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
Request Example for get/v1/beta/similarweb/search/website-keywords
curl 'https://openapi.felo.ai/v1/beta/similarweb/search/website-keywords?domain=example.com&end_date=2026-09&granularity=monthly&limit=1&start_date=2026-09' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "meta": {
    "status": "success",
    "last_updated": "2026-06-30",
    "request": {},
    "query": {}
  },
  "data": [
    {
      "keyword": null,
      "clicks": null,
      "traffic_share": null,
      "competition": null,
      "primary_intent": null,
      "secondary_intent": null,
      "position": null,
      "serp_features": [
        "string"
      ],
      "top_url": null,
      "url_count": null
    }
  ]
}
Website Keywords