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

تنظیم وظایف ‘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 عملیات

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

​

حجم جستجوی Bing برای فهرستی از keywords. keyword، location_code، language_code، search_partners، device، competition، cpc، search_volume، categories و monthly_searches را برمی‌گرداند — به categories توجه کنید که معادل Google آن را برنمی‌گرداند، و competition_index هم وجود ندارد. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. همزاد Google post_dataforseo_keywords_gads_search_volume_live است؛ وقتی مخاطب فقط Google نیست هر دو را اجرا کنید. همزادهای ارسال و واکشی این نقطه پایانی همان کار را به‌صورت ناهمگام و با همان قیمت، برای دسته‌های بزرگ‌تر از آنکه بتوان منتظرشان ماند، انجام می‌دهند.

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

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

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

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

      تاریخ شروع بازه زمانی
      فیلد اختیاری
      حداقل مقدار: 24 ماه از تاریخ امروز؛
      اگر این فیلد را تعیین نکنید، داده‌های 12 ماه گذشته ارائه می‌شود؛
      حداقل مقدار: دو سال پیش از تاریخ امروز؛
      اگر نقطه پایانی Status در فیلد actual_data مقدار false برگرداند، می‌توان date_from را روی ماه قبل از ماه گذشته و پیش‌تر تنظیم کرد؛
      اگر نقطه پایانی Status در فیلد actual_data مقدار true برگرداند، می‌توان date_from را روی ماه گذشته و پیش‌تر تنظیم کرد؛
      قالب تاریخ: "yyyy-mm-dd"
      مثال:
      "2020-01-01"نکته: استفاده از بازه زمانی سفارشی برای تاریخ‌های سال گذشته را توصیه نمی‌کنیم

    • date_to
      نوع: string | null

      تاریخ پایان بازه زمانی
      فیلد اختیاری
      اگر این فیلد را تعیین نکنید، داده‌های 12 ماه گذشته ارائه می‌شود؛
      حداقل مقدار: دو سال پیش از تاریخ امروز؛
      حداکثر مقدار: یک ماه از تاریخ امروز؛
      نکته: استفاده از بازه زمانی سفارشی برای تاریخ‌های سال گذشته را توصیه نمی‌کنیم؛
      قالب تاریخ: "yyyy-mm-dd"
      مثال:
      "2020-03-15"نکته: استفاده از بازه زمانی سفارشی برای تاریخ‌های سال گذشته را توصیه نمی‌کنیم

    • device
      نوع: string | null

      نوع دستگاه
      فیلد اختیاری
      اگر می‌خواهید داده‌ها را برای نوع دستگاه خاصی دریافت کنید، این فیلد را تعیین کنید؛
      مقادیر ممکن: all، mobile، desktop، tablet
      مقدار پیش‌فرض: all

    • keywords
      نوع: array string[]

      کلمات کلیدی
      فیلد الزامی
      حداکثر تعداد کلمات کلیدی که می‌توانید تعیین کنید: 1000
      حداکثر تعداد نویسه برای هر کلمه کلیدی: 100
      کلمات کلیدی مشخص‌شده به حروف کوچک تبدیل می‌شوند و داده‌ها در آرایه‌ای جداگانه ارائه می‌شود. درباره قواعد و محدودیت‌های فیلدهای keyword و keywords در APIهای DataForSEO در این مقاله مرکز راهنمایی بیشتر بدانید

    • language_code
      نوع: string

      کد زبان موتور جستجو
      فیلد الزامی اگر تعیین نکنید language_name
      در صورت استفاده از این فیلد، نیازی به تعیین language_name نیست
      زبان‌های پشتیبانی‌شده:
      en، fr، de

    • language_name
      نوع: string

      نام کامل زبان موتور جستجو
      فیلد الزامی اگر تعیین نکنید language_code
      در صورت استفاده از این فیلد، نیازی به تعیین language_code نیست
      زبان‌های پشتیبانی‌شده:
      English، French، German

    • location_code
      نوع: integer

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

    • location_coordinate
      نوع: string

      مختصات GPS یک موقعیت
      فیلد الزامی اگر تعیین نکنید location_name یا location_code
      در صورت استفاده از این فیلد، نیازی به تعیین location_name یا location_code نیست
      پارامتر location_coordinate باید در قالب "latitude,longitude" مشخص شود
      داده‌ها برای کشوری که مختصات مشخص‌شده به آن تعلق دارند ارائه می‌شود
      مثال:
      52.6178549,-155.352142

    • location_name
      نوع: string

      نام کامل موقعیت موتور جستجو
      فیلد الزامی اگر تعیین نکنید location_code یا location_coordinate
      در صورت استفاده از این فیلد، نیازی به تعیین location_code یا location_coordinate نیست
      می‌توانید فهرست موقعیت‌های موجود موتور جستجو را همراه با location_name آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/keywords_data/bing/locations دریافت کنید
      مثال:
      London,England,United Kingdom

    • search_partners
      نوع: boolean | null

      نوع شرکای جستجوی Bing
      فیلد اختیاری
      اگر true را تعیین کنید، نتایج برای شبکه‌های تحت مالکیت، تحت بهره‌برداری و توزیع‌شده در Bing، Yahoo، AOL و سایت‌های شریکی که میزبان جستجوی Bing، AOL و Yahoo هستند ارائه می‌شود.
      مقدار پیش‌فرض: false — نتایج برای شبکه‌های جستجوی Bing، AOL و Yahoo برگردانده می‌شوند

    • sort_by
      نوع: string | null

      پارامترهای مرتب‌سازی نتایج
      فیلد اختیاری
      از این پارامترها برای مرتب‌سازی نتایج بر اساس search_volume، cpc، competition یا relevance به ترتیب نزولی استفاده کنید
      مقدار پیش‌فرض: relevance

    • tag
      نوع: string | null

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

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

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

    • status_code
      نوع: integer | null

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

    • status_message
      نوع: string | null

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

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

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

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

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

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

            دسته‌های محصول و خدمات
            API ما برای این نقطه پایانی دسته‌ها را برنمی‌گرداند: پارامتر همیشه برابر null خواهد بود

          • competition
            نوع: number | null

            رقابت
            میزان نسبی رقابت مرتبط با کلیدواژه مشخص را فقط در SERP پرداختی نشان می‌دهد. این مقدار بر پایه داده‌های Bing Ads است.
            مقادیر ممکن: 0.1، 0.5،0.90.1 - رقابت کم،
            0.5 - رقابت متوسط،
            0.9 - رقابت زیاد؛
            اگر داده‌ای نباشد مقدار null است

          • cpc
            نوع: number | null

            هزینه هر کلیک
            میانگین هزینه هر کلیک (دلار آمریکا) را نشان می‌دهد که به‌طور تاریخی برای کلیدواژه پرداخت شده است.
            اگر داده‌ای نباشد مقدار_nulln است

          • device
            نوع: string | null

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

          • keyword
            نوع: string | null

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

          • language_code
            نوع: string | null

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

          • location_code
            نوع: integer | null

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

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

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

            • month
              نوع: integer | null

              ماه

            • search_volume
              نوع: integer | null

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

            • year
              نوع: integer | null

              سال

          • search_partners
            نوع: boolean | null

            نشان می‌دهد آیا داده‌های شبکه‌های شریک در پاسخ گنجانده شده‌اند

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

            نرخ میانگین حجم جستجوی ماهانه
            تعداد (تقریبی) جستجوهای ایده کلیدواژه داده‌شده در موتور جستجوی bing را بسته به هدف‌گیری کاربر نشان می‌دهد؛
            حجم جستجو به نزدیک‌ترین ده‌ها گرد می‌شود؛
            اگر داده‌ای نباشد، مقدار_nulln است

        • 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/bing/search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "United States",
    "language_code": "en",
    "keywords": [
      "tom and jerry",
      "silicon valley",
      "spider man"
    ]
  }
]'

{
  "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,
          "location_code": null,
          "language_code": null,
          "search_partners": null,
          "device": null,
          "competition": null,
          "cpc": null,
          "search_volume": null,
          "categories": [
            null
          ],
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

عملیات موفق

Setting Live ‘Search Volume’ Tasks