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

تنظیم وظایف ‘DataForSEO Search Volume’ زنده

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

DataForSEO

​

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

DataForSEO عملیات

تنظیم وظایف ‘DataForSEO Search Volume’ زنده

​

حجم جستجوی برگرفته از پنل‌های Clickstream نه پلتفرم‌های تبلیغاتی، برای فهرستی از keywords. use_clickstream ترکیب را تغییر می‌دهد. location_code، language_code، use_clickstream، items_count و items را برمی‌گرداند. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. حجم Clickstream اغلب با post_dataforseo_keywords_gads_search_volume_live اختلاف دارد و همین نکته است: یکی آنچه به تبلیغ‌دهندگان نشان داده می‌شود را می‌سنجد و دیگری آنچه مردم انجام داده‌اند.

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

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

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

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

      کلمات کلیدی هدف
      فیلد الزامی
      کدگذاری UTF-8
      حداکثر تعداد کلمات کلیدی که می‌توانید در این آرایه تعیین کنید: 1000
      کلمات کلیدی به قالب حروف کوچک تبدیل می‌شوند

      نکته: نمادها و نویسه‌های خاصی (مثلاً نمادهای UTF، ایموجی‌ها) مجاز نیستند
      برای اطلاع از اینکه چه نمادها و نویسه‌هایی قابل استفاده هستند، به این مقاله مراجعه کنید

      درباره قواعد و محدودیت‌های فیلدهای keyword و keywords در APIهای DataForSEO در این مقاله مرکز راهنمایی بیشتر بدانید

    • language_code
      نوع: string

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

    • language_name
      نوع: string

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

    • location_code
      نوع: integer

      کد موقعیت موتور جستجو
      فیلد الزامی اگر location_name را تعیین نکنید
      در صورت استفاده از این فیلد، می‌توانید فهرست موقعیت‌های موجود را همراه با location_code با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages دریافت کنید
      مثال:
      2826

    • location_name
      نوع: string

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

    • tag
      نوع: string | null

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

    • use_clickstream
      نوع: boolean | null

      استفاده از داده‌های clickstream برای ارائه نتایج
      فیلد اختیاری
      اگر روی true تنظیم شود، مقادیر حجم جستجوی DataForSEO را بر اساس داده‌های clickstream دریافت می‌کنید؛
      اگر روی false تنظیم شود، از داده‌های حجم جستجوی Bing برای محاسبه حجم جستجوی DataForSEO استفاده می‌شود؛
      مقدار پیش‌فرض: true؛
      نکته: حجم جستجوی Bing برای موقعیت‌های موجود در نقاط پایانی Bing Search Volume History Locations و Bing Ads Locations در دسترس است؛ مقادیر حجم جستجو برای هر موقعیت دیگری بر اساس داده‌های clickstream محاسبه می‌شود، حتی اگر این پارامتر را روی false تنظیم کنید

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

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

    • status_code
      نوع: integer | null

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

    • status_message
      نوع: string | null

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

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

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

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

            آرایه کلیدواژه‌ها
            کلیدواژه‌ها و نرخ‌های حجم جستجوی آن‌ها را در بر می‌گیرد

            • keyword
              نوع: string | null

              کلیدواژه ارائه‌شده در آرایه POST

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

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

              • month
                نوع: integer | null

                ماه

              • search_volume
                نوع: integer | null

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

              • year
                نوع: integer | null

                سال

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

              نرخ فعلی حجم جستجوی یک کلیدواژه

          • items_count
            نوع: integer | null

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

          • language_code
            نوع: string | null

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

            توجه:اگر کلیدواژه در آرایه POST دارای غلط املایی به نظر برسد، داده‌ها برای کلیدواژه با املای صحیح بازگردانده می‌شوند؛
            ما از قابلیت Google Ads API برای بررسی و اعتبارسنجی املای کلیدواژه‌ها استفاده می‌کنیم، از این پیوند بیشتر بدانید

          • location_code
            نوع: integer | null

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

          • use_clickstream
            نوع: boolean | null

            نشان می‌دهد آیا پارامتر use_clickstream فعال است
            مقادیر ممکن: true، false

        • 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/keywords_data/clickstream_data/dataforseo_search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/clickstream_data/dataforseo_search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_code": "en",
    "tag": "test-tag",
    "keywords": [
      "you tube",
      "youtube",
      "youtub"
    ]
  }
]'

{
  "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": [
        {
          "location_code": null,
          "language_code": null,
          "use_clickstream": null,
          "items_count": null,
          "items": [
            {
              "keyword": null,
              "search_volume": null,
              "monthly_searches": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

عملیات موفق

Setting Live ‘DataForSEO Search Volume’ Tasks