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

نمای کلی رتبه دامنه

Felo API Support
MIT
سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO عملیات

نمای کلی رتبه دامنه

​

ردپای جستجوی یک دامنه: تعداد کلیدواژه‌های ارگانیک و پرداختی، ترافیک برآوردی و ارزش ترافیک، بر اساس location_code. se_type، target، total_count، items_count و items را برمی‌گرداند. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. برای همان اعداد در طول زمان از post_dataforseo_labs_google_historical_rank_live و برای دامنه‌های بسیاری به‌طور هم‌زمان از post_dataforseo_labs_google_bulk_traffic_estimation_live استفاده کنید.

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

  • اندازه‌گیری: هزینه گزارش‌شده پاسخ.
  • برآورد درخواست مرجع: 0.0121 دلار آمریکا.
  • ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.

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

بدنه
application/json
  • نوع: array (object | null)[]
    • ignore_synonyms
      نوع: boolean | null

      نادیده‌گرفتن کلیدواژه‌های بسیار مشابه
      فیلد اختیاری
      اگر روی true تنظیم شود، همه کلیدواژه‌های بسیار مشابه از محاسبات رتبه‌بندی و ترافیک حذف می‌شوند و نتایج بر پایه داده‌های کلیدواژه‌های اصلی از گروه‌های مترادف خواهد بود
      مقدار پیش‌فرض: false

    • language_code
      نوع: string | null

      کد زبان
      فیلد اختیاری
      اگر از این فیلد استفاده کنید، نیازی به تعیین language_name ندارید
      فهرست زبان‌های موجود همراه با language_code آن‌ها را می‌توانید با ارسال یک درخواست جداگانه به
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages دریافت کنید
      برای دریافت نتایج همه زبان‌های موجود، این فیلد را نادیده بگیرید
      نمونه:
      en

    • language_name
      نوع: string | null

      نام کامل زبان
      فیلد اختیاری
      اگر از این فیلد استفاده کنید، نیازی به تعیین language_code ندارید
      فهرست زبان‌های موجود همراه با language_name آن‌ها را می‌توانید با ارسال یک درخواست جداگانه به
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages دریافت کنید
      برای دریافت نتایج همه زبان‌های موجود، این فیلد را نادیده بگیرید
      نمونه:
      English

    • limit
      نوع: integer | null

      حداکثر تعداد نتایج برگردانده‌شده برای هر دامنه
      فیلد اختیاری
      مقدار پیش‌فرض: 100
      حداکثر مقدار: 1000

    • location_code
      نوع: integer | null

      کد مکان
      فیلد اختیاری
      اگر از این فیلد استفاده کنید، نیازی به تعیین location_name ندارید
      فهرست مکان‌های موجود همراه با location_code آن‌ها را می‌توانید با ارسال یک درخواست جداگانه به
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages دریافت کنید
      برای دریافت نتایج همه مکان‌های موجود، این فیلد را نادیده بگیرید
      نمونه:
      2840

    • location_name
      نوع: string | null

      نام کامل مکان
      فیلد اختیاری
      اگر از این فیلد استفاده کنید، نیازی به تعیین location_code ندارید
      فهرست مکان‌های موجود همراه با location_name آن‌ها را می‌توانید با ارسال یک درخواست جداگانه به
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages دریافت کنید
      برای دریافت نتایج همه مکان‌های موجود، این فیلد را نادیده بگیرید
      نمونه:
      United Kingdom

    • offset
      نوع: integer | null

      افست در آرایه نتایج آیتم‌های برگردانده‌شده
      فیلد اختیاری
      مقدار پیش‌فرض: 0
      اگر مقدار 10 را تعیین کنید، ده items اول در آرایه نتایج حذف می‌شود و داده‌ها برای آیتم‌های بعدی ارائه می‌شود

    • tag
      نوع: string | null

      شناسه وظیفه تعریف‌شده توسط کاربر
      فیلد اختیاری
      محدودیت کاراکتر 255 است
      می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
      مقدار tag مشخص‌شده را در شیء data پاسخ پیدا می‌کنید

    • target
      نوع: string

      دامنه
      فیلد الزامی
      نام دامنه وب‌سایت هدف
      دامنه باید بدون https:// و www. تعیین شود

پاسخ‌ها
  • 200
    نوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo
    • cost
      نوع: number | null قالب: double

      هزینه کل وظایف، دلار آمریکا

    • status_code
      نوع: integer | null

      کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید

    • status_message
      نوع: string | null

      پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید

    • tasks
      نوع: array (object | null)[] | null

      آرایه‌ای از وظایف

      • نوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo
        • cost
          نوع: number | null قالب: double

          هزینه کل وظایف، دلار آمریکا

        • data
          نوع: object | null

          همان پارامترهایی را دارد که در درخواست POST تعیین کرده‌اید

          • propertyName
            نوع: object | null
        • id
          نوع: string | null

          شناسه وظیفه شناسه یکتای وظیفه در سیستم ما در قالب UUID

        • path
          نوع: array (string | null)[] | null

          مسیر URL

        • result
          نوع: array (object | null)[] | null

          آرایه‌ای از نتایج

          • items
            نوع: array (object | null)[] | null

            شامل داده‌های رتبه‌بندی و ترافیک است

            • language_code
              نوع: string | null

              کد زبان در آرایه POST

            • location_code
              نوع: integer | null

              کد مکان در آرایه POST

            • metrics
              نوع: object | null

              داده‌های رتبه‌بندی مرتبط با دامنه مشخص‌شده

              • propertyName
                نوع: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
                • clickstream_age_distribution
                  نوع: object | null

                  توزیع معیارهای مبتنی بر clickstream بر اساس سن
                  برای دریافت نتایج این فیلد، پارامتر include_clickstream_data باید روی true تنظیم شود
                  درباره نحوه محاسبه این معیار در این مقاله مرکز راهنما بیشتر بدانید

                  • propertyName
                    نوع: integer | null قالب: int64

                    Signed 64-bit integers (long type).

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

                  حجم ترافیک تخمینی بر اساس داده‌های clickstream
                  به‌صورت حاصل‌ضرب نرخ کلیک و مقادیر حجم جستجوی clickstream همه کلیدواژه‌هایی که دامنه برای آن‌ها رتبه دارد محاسبه می‌شود
                  برای دریافت نتایج این فیلد، پارامتر include_clickstream_data باید روی true تنظیم شود
                  درباره نحوه محاسبه این معیار در این مقاله مرکز راهنما بیشتر بدانید

                • clickstream_gender_distribution
                  نوع: object | null

                  توزیع معیارهای تخمینی مبتنی بر clickstream بر اساس جنسیت
                  برای دریافت نتایج این فیلد، پارامتر include_clickstream_data باید روی true تنظیم شود
                  درباره نحوه محاسبه این معیار در این مقاله مرکز راهنما بیشتر بدانید

                  • propertyName
                    نوع: integer | null قالب: int64

                    Signed 64-bit integers (long type).

                • count
                  نوع: integer | null قالب: int64

                  تعداد کل SERPهای ارگانیکی که دامنه یا زیردامنه را شامل می‌شوند

                • estimated_paid_traffic_cost
                  نوع: number | null

                  هزینه تخمینی تبدیل ترافیک جستجوی ارگانیک به ترافیک پرداختی
                  هزینه ماهانه تخمینی (به دلار آمریکا) را برای اجرای تبلیغات همه کلیدواژه‌های دسته‌بندی‌ای که دامنه یا زیردامنه برای آن‌ها رتبه دارد نشان می‌دهد
                  این معیار به‌صورت حاصل‌ضرب مقادیر etv ارگانیک و cpc پرداختی محاسبه می‌شود و هزینه جذب حجم تخمینی ترافیک ارگانیک ماهانه را از طریق تبلیغات PPC در جستجوی Google نشان می‌دهد
                  درباره نحوه محاسبه این معیار در این مقاله مرکز راهنما بیشتر بدانید

                • etv
                  نوع: number | null

                  حجم ترافیک تخمینی
                  ترافیک ارگانیک ماهانه تخمینی به دامنه یا زیردامنه
                  به‌صورت حاصل‌ضرب مقادیر CTR (نرخ کلیک) و حجم جستجوی همه کلیدواژه‌های دسته‌بندی‌ای که دامنه یا زیردامنه برای آن‌ها رتبه دارد محاسبه می‌شود
                  درباره نحوه محاسبه این معیار در این مقاله مرکز راهنما بیشتر بدانید

                • is_down
                  نوع: integer | null

                  رتبه کاهش یافت
                  نشان می‌دهد چند عنصر رتبه‌بندی‌شده از هدف مشخص‌شده کاهش رتبه داشته‌اند

                • is_lost
                  نوع: integer | null

                  عناصر رتبه‌بندی‌شده از دست‌رفته
                  نشان می‌دهد چند عنصر رتبه‌بندی‌شده از هدف مشخص‌شده پیش‌تر در SERP نمایش داده می‌شدند اما در آخرین بررسی یافت نشدند

                • is_new
                  نوع: integer | null

                  تعداد عناصر رتبه‌بندی‌شده جدید
                  نشان می‌دهد چند عنصر رتبه‌بندی‌شده جدید برای هدف مشخص‌شده یافت شده است

                • is_up
                  نوع: integer | null

                  رتبه افزایش یافت
                  نشان می‌دهد چند عنصر رتبه‌بندی‌شده از هدف مشخص‌شده افزایش رتبه داشته‌اند

                • pos_1
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #1 دارد

                • pos_11_20
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #11-20 دارد

                • pos_2_3
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #2-3 دارد

                • pos_21_30
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #21-30 دارد

                • pos_31_40
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #31-40 دارد

                • pos_4_10
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #4-10 دارد

                • pos_41_50
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #41-50 دارد

                • pos_51_60
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #51-60 دارد

                • pos_61_70
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #61-70 دارد

                • pos_71_80
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #71-80 دارد

                • pos_81_90
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #81-90 دارد

                • pos_91_100
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که دامنه یا زیردامنه در آن‌ها رتبه #91-100 دارد

            • se_type
              نوع: string | null

              نوع موتور جستجو

          • items_count
            نوع: integer | null قالب: int64

            تعداد نتایج بازگردانده‌شده در آرایه items

          • language_code
            نوع: string | null

            کد زبان در آرایه POST

          • location_code
            نوع: integer | null

            کد مکان در آرایه POST

          • se_type
            نوع: string | null

            نوع موتور جستجو

          • target
            نوع: string | null

            دامنه هدف در آرایه POST

          • total_count
            نوع: integer | null قالب: int64

            مجموع کل نتایج در پایگاه داده ما مرتبط با درخواست شما

        • result_count
          نوع: integer | null قالب: int64

          تعداد عناصر در آرایه result

        • status_code
          نوع: integer | null

          کد وضعیت وظیفه توسط DataForSEO تولید می‌شود و می‌تواند در بازه زیر باشد: 10000-60000 فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید

        • status_message
          نوع: string | null

          پیام اطلاعاتی وظیفه فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید

        • time
          نوع: string | null

          زمان اجرا، ثانیه

    • tasks_count
      نوع: integer | null قالب: int64

      تعداد وظایف در آرایه tasks

    • tasks_error
      نوع: integer | null قالب: int64

      تعداد وظایف در آرایه tasks که با خطا برگردانده شده‌اند

    • time
      نوع: string | null

      زمان کل اجرا، بر حسب ثانیه

    • version
      نوع: string | null

      نسخه فعلی API

    application/json
  • 400

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

  • 401

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

  • 402

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

  • 403

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

  • 429

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

  • 502

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

  • 503

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

  • 504

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

  • default

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

    application/json
Request Example for post/v1/beta/dataforseo/dataforseo_labs/google/domain_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/domain_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "language_name": "English",
    "location_code": 2840
  }
]'

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "se_type": null,
          "target": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "location_code": null,
              "language_code": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

عملیات موفق

Domain Rank Overview