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 عملیات

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

​

نمای کلی رتبه یک دامنه در هر نقطه از تاریخچه موجود. این عملیات پارامتر limit ندارد، اما قیمت‌گذاری آن به‌ازای هر فراخوانی است نه هر آیتم، پس کل فهرست را یک‌جا ارسال کنید. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. ابتدا get_dataforseo_labs_google_available_history را بررسی کنید — تاریخ‌های موجود را نام می‌برد و درخواست تاریخی خارج از آن‌ها چیزی برنمی‌گرداند نه خطا. تصویر لحظه‌ای فعلی post_dataforseo_labs_google_domain_rank_overview_live است.

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

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

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

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

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

    • date_from
      نوع: string | null

      تاریخ شروع بازه زمانی
      فیلد اختیاری
      اگر این فیلد را تعیین نکنید، داده‌ها برای 6 ماه گذشته ارائه می‌شود
      کمینه مقدار ممکن: 2020-10-01
      قالب تاریخ: "yyyy-mm-dd"

    • date_to
      نوع: string | null

      تاریخ پایان بازه زمانی
      فیلد اختیاری
      اگر این فیلد را تعیین نکنید، به‌طور پیش‌فرض تاریخ امروز استفاده می‌شود
      قالب تاریخ: "yyyy-mm-dd"
      نمونه:
      "2021-04-01"

    • ignore_synonyms
      نوع: boolean | null

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

    • include_clickstream_data
      نوع: boolean | null

      شامل‌کردن یا حذف داده‌های معیارهای مبتنی بر Clickstream در نتیجه
      فیلد اختیاری
      اگر پارامتر روی true تنظیم شود، فیلدهای clickstream_etv، clickstream_gender_distribution و clickstream_age_distribution را همراه با داده‌های Clickstream در پاسخ دریافت می‌کنید؛
      مقدار پیش‌فرض: false؛

      توجه: داده‌های تاریخی Clickstream از 2024/05 (مه 2024) در دسترس است؛
      با فعال‌بودن این پارامتر، هزینه درخواست دو برابر محاسبه می‌شود؛
      درباره نحوه محاسبه معیارهای مبتنی بر Clickstream در این مقاله مرکز راهنمایی بیشتر بدانید

    • language_code
      نوع: string | null

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

    • language_name
      نوع: string

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

    • location_code
      نوع: integer

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

    • location_name
      نوع: string

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

    • tag
      نوع: string | null

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

    • target
      نوع: string

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

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

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

    • status_code
      نوع: integer | null

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

    • status_message
      نوع: string | null

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

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

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

      • نوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalRankOverviewLiveTaskInfo
        • 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

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

            • 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 دارد

            • month
              نوع: integer | null

              ماهی که داده‌ها برای آن ارائه شده است

            • se_type
              نوع: string | null

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

            • year
              نوع: integer | 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/historical_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/historical_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "location_code": 2840,
    "language_code": "en",
    "date_from": "2021-01-01",
    "date_to": "2021-03-29"
  }
]'

{
  "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,
              "year": null,
              "month": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

عملیات موفق

Historical Rank Overview