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

دریافت نتایج ‘Keywords For Site’ بر اساس id

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

DataForSEO

​

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

دریافت نتایج ‘Keywords For Site’ بر اساس id

​

وظیفه کلیدواژه‌های Google Ads برای سایت را که در صف قرار گرفته، بر اساس id بازیابی می‌کند. 🔴 همان مرتبه 7.2 MB نسخه زنده. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند.

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

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

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

پارامترهای مسیر
  • id
    نوع: string
    الزامی

    شناسه وظیفه
    شناسه وظیفه یکتا در سیستم ما با قالب UUID
    می‌توانید تا 30 روز از آن برای درخواست نتایج وظیفه در هر زمان استفاده کنید

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

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

    • status_code
      نوع: integer | null

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

    • status_message
      نوع: string | null

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

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

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

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

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

          • competition
            نوع: string | null

            رقابت
            سطح نسبی رقابت مرتبط با کلیدواژه مشخص را فقط در SERP پرداختی نشان می‌دهد
            مقادیر ممکن: LOW، MEDIUM، HIGH
            اگر سطح رقابت نامشخص باشد، مقدار null است؛
            درباره این معیار در این مقاله مرکز راهنما بیشتر بدانید

          • competition_index
            نوع: integer | null

            شاخص رقابت
            شاخص رقابت برای پرس‌وجو که نشان می‌دهد جای‌گیری تبلیغ برای کلیدواژه تا چه اندازه رقابتی است
            می‌تواند مقادیری از 0 تا 100 داشته باشد
            سطح رقابت از 0 تا 100 با تقسیم تعداد جایگاه‌های پرشده تبلیغ بر تعداد کل جایگاه‌های تبلیغ موجود تعیین می‌شود
            اگر داده کافی نباشد، مقدار null است؛
            درباره این معیار در این مقاله مرکز راهنما بیشتر بدانید

          • cpc
            نوع: number | null

            هزینه هر کلیک
            مبلغ پرداخت‌شده (دلار آمریکا) را برای هر کلیک روی تبلیغ نمایش‌داده‌شده برای یک کلیدواژه مشخص نشان می‌دهد

          • high_top_of_page_bid
            نوع: number | null

            حداکثر پیشنهاد برای نمایش تبلیغ در بالای صفحه اول
            مقداری را نشان می‌دهد که بزرگ‌تر از حدود 80% کمترین پیشنهادهایی است که تبلیغات در آن‌ها نمایش داده شده‌اند (بر پایه آمار Google Ads برای تبلیغ‌دهندگان)
            این مقدار بسته به موقعیت مشخص‌شده در درخواست POST می‌تواند متفاوت باشد

          • keyword
            نوع: string | null

            کلیدواژه در آرایه POST

          • language_code
            نوع: string | null

            کد زبان در آرایه POST
            اگر داده‌ای نباشد، مقدار_nulln است

          • location_code
            نوع: integer | null

            کد موقعیت در آرایه POST
            اگر داده‌ای نباشد، مقدار_nulln است

          • low_top_of_page_bid
            نوع: number | null

            حداقل پیشنهاد برای نمایش تبلیغ در بالای صفحه اول
            مقداری را نشان می‌دهد که بزرگ‌تر از حدود 20% کمترین پیشنهادهایی است که تبلیغات در آن‌ها نمایش داده شده‌اند (بر پایه آمار Google Ads برای تبلیغ‌دهندگان)
            این مقدار بسته به موقعیت مشخص‌شده در درخواست POST می‌تواند متفاوت باشد

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

            جستجوهای ماهانه
            تعداد (تقریبی) جستجوهای این ایده کلیدواژه (به‌صورت موجود برای دوازده ماه گذشته) را نشان می‌دهد که به موقعیت‌های جغرافیایی مشخص‌شده هدف‌گیری شده‌اند
            اگر داده‌ای نباشد، مقدار null است

            • month
              نوع: integer | null

              ماه

            • search_volume
              نوع: integer | null

              نرخ میانگین حجم جستجوی ماهانه

            • year
              نوع: integer | null

              سال

          • search_partners
            نوع: boolean | null

            شامل شرکای جستجوی Google
            مقداری که هنگام تنظیم وظیفه مشخص کرده‌اید
            اگر true باشد، نتایج برای شبکه‌های تحت مالکیت، بهره‌برداری و توزیع Google و سایت‌های شریکی که میزبان جستجوی Google هستند بازگردانده می‌شوند؛
            اگر false باشد، نتایج فقط برای سایت‌های جستجوی Google بازگردانده می‌شوند

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

            نرخ میانگین حجم جستجوی ماهانه
            تعداد (تقریبی) جستجوهای ایده کلیدواژه داده‌شده را یا در google.com یا در google.com و شرکا، بسته به هدف‌گیری کاربر نشان می‌دهد
            اگر داده‌ای نباشد، مقدار null است

          • spell
            نوع: string | null
        • 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 get/v1/beta/dataforseo/keywords_data/google_ads/keywords_for_site/task_get/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/keywords_for_site/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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": [
        {
          "keyword": null,
          "spell": null,
          "location_code": null,
          "language_code": null,
          "search_partners": null,
          "competition": null,
          "competition_index": null,
          "search_volume": null,
          "low_top_of_page_bid": null,
          "high_top_of_page_bid": null,
          "cpc": null,
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}
Get ‘Keywords For Site’ Results by id

به کمک نیاز دارید؟

  • برای پرسش‌های مربوط به API، صورت‌حساب و حساب کاربری با پشتیبانی در تماس باشید.
  • با توسعه‌دهندگان Felo در Discord گفت‌وگو کنید.
  • تاریخچه تغییرات ما را ببینید.
  • به قیمت‌گذاری حجمی یا کمک در خرید نیاز دارید؟ تماس با فروش.
  • با LLM می‌سازید؟ llms.txt را بخوانید.