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

تنظیم وظایف ‘DataForSEO Trends Subregion Interests’ زنده

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

DataForSEO

​

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

DataForSEO عملیات

تنظیم وظایف ‘DataForSEO Trends Subregion Interests’ زنده

​

جایی که علاقه به یک کلیدواژه متمرکز است، با تفکیک بر اساس زیرمنطقه در location_code. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. برای «چه کسی» به‌جای «کجا»، از post_dataforseo_keywords_trends_demography_live استفاده کنید.

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

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

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

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

      تاریخ شروع بازه زمانی
      فیلد اختیاری
      اگر این فیلد را تعیین نکنید، به‌طور پیش‌فرض از روز و ماه جاری سال قبل استفاده می‌شود
      حداقل مقدار برای نوع web: 2004-01-01
      حداقل مقدار برای انواع دیگر: 2008-01-01
      قالب تاریخ: "yyyy-mm-dd"
      مثال:
      "2019-01-15"

    • date_to
      نوع: string | null

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

    • keywords
      نوع: array string[]

      کلمات کلیدی
      فیلد الزامی
      حداکثر تعداد کلمات کلیدی که می‌توانید تعیین کنید: 5
      از نمادها و نویسه‌های خاص (مانند نمادهای UTF و ایموجی‌ها) خودداری کنید؛
      اگر نویسه‌های غیرلاتین را مشخص کنید، داده‌های مربوط به کشورهایی را دریافت می‌کنید که در آن‌ها استفاده می‌شوند

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

    • location_code
      نوع: integer | null

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

    • location_name
      نوع: string | null

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

    • tag
      نوع: string | null

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

    • time_range
      نوع: string | null

      بازه‌های زمانی از پیش تعیین‌شده
      فیلد اختیاری
      اگر پارامترهای date_from یا date_to را مشخص کنید، این فیلد هنگام تنظیم وظیفه نادیده گرفته می‌شود
      مقادیر ممکن برای همه پارامترهای type:
      past_4_hours، past_day، past_7_days، past_30_days، past_90_days، past_12_months، past_5_years

    • type
      نوع: string | null

      نوع عنصر

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

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

    • status_code
      نوع: integer | null

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

    • status_message
      نوع: string | null

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

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

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

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

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

          • datetime
            نوع: string | null

            تاریخ و زمانی که نتیجه دریافت شده است
            در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            مثال:
            2019-11-15 12:57:46 +00:00

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

            محبوبیت کلیدواژه و داده‌های مرتبط را در بر می‌گیرد

            • نوع: object | null · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
                • نوع: object · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
                  • type
                    تمایزدهنده
                    نوع: string | null

                    نوع عنصر

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

                    داده‌های محبوبیت زیرمنطقه‌ای کلیدواژه برای هر عبارت مشخص‌شده

                    • keyword
                      نوع: string | null

                      کلیدواژه مرتبط
                      داده‌های موجود در عنصر values بر این کلیدواژه مبتنی است

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

                      حاوی داده‌هایی درباره محبوبیت نسبی کلمات کلیدی بر اساس کشور یا منطقه است

                      • geo_id
                        نوع: string | null

                        شناسه موقعیت
                        می‌توانید از این فیلد برای تطبیق نتایج به‌دست‌آمده با پارامترهای موقعیت مشخص‌شده در درخواست استفاده کنید
                        فهرست کامل موقعیت‌های موجود همراه با geo_id آن‌ها را اینجا ببینید یا درخواست جداگانه‌ای به https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations بفرستید
                        مثال:
                        US-NY

                      • geo_name
                        نوع: string | null

                        نام موقعیت
                        می‌توانید از این فیلد برای تطبیق نتایج به‌دست‌آمده با پارامترهای موقعیت مشخص‌شده در درخواست استفاده کنید
                        فهرست کامل موقعیت‌های موجود همراه با geo_name آن‌ها را اینجا ببینید یا درخواست جداگانه‌ای به https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations بفرستید
                        مثال:
                        Andorra

                      • value
                        نوع: integer | null

                        نرخ محبوبیت نسبی کلیدواژه در یک مکان مشخص
                        نرخ محبوبیت کلیدواژه مخصوص مکان را در بازه زمانی مشخص‌شده نشان می‌دهد
                        با استفاده از این value می‌توانید دریابید که یک کلیدواژه در یک مکان در مقایسه با مکان دیگر چقدر محبوب است
                        محاسبه: بالاترین مقدار محبوبیت را برای کلیدواژه مرتبط در همه مکان‌ها تعیین می‌کنیم و سپس همه مقادیر دیگر را به‌صورت درصدی از آن بالاترین مقدار (100) بیان می‌کنیم
                        مقدار 100 بالاترین محبوبیت عبارت است
                        مقدار 50 یعنی محبوبیت عبارت نصف است
                        مقدار 0 یعنی داده کافی برای این عبارت وجود نداشته است

                  • interests_comparison
                    نوع: object | null · Response36Afe1097B20_InterestsComparison

                    مقایسه داده‌های محبوبیت زیرمنطقه‌ای کلیدواژه برای پارامترهای مشخص‌شده
                    اگر یک کلیدواژه تعیین کنید، مقدار null خواهد بود

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

                      نرخ‌های محبوبیت کلیدواژه در همه مکان‌ها
                      مقادیر این آرایه درصدهایی نسبت به حداکثر مقدار در همه مکان‌ها را نشان می‌دهند

                      • geo_id
                        نوع: string | null

                        شناسه موقعیت
                        می‌توانید از این فیلد برای تطبیق نتایج به‌دست‌آمده با پارامترهای موقعیت مشخص‌شده در درخواست استفاده کنید
                        فهرست کامل موقعیت‌های موجود همراه با geo_id آن‌ها را اینجا ببینید یا درخواست جداگانه‌ای به https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations بفرستید
                        مثال:
                        US-NY

                      • geo_name
                        نوع: string | null

                        نام موقعیت
                        می‌توانید از این فیلد برای تطبیق نتایج به‌دست‌آمده با پارامترهای موقعیت مشخص‌شده در درخواست استفاده کنید
                        فهرست کامل موقعیت‌های موجود همراه با geo_name آن‌ها را اینجا ببینید یا درخواست جداگانه‌ای به https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations بفرستید
                        مثال:
                        Andorra

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

                        حاوی داده‌هایی درباره محبوبیت نسبی کلمات کلیدی بر اساس کشور یا منطقه است

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

                      محبوبیت کلیدواژه و داده‌های مرتبط را در بر می‌گیرد

                      • geo_id
                        نوع: string | null

                        شناسه موقعیت
                        می‌توانید از این فیلد برای تطبیق نتایج به‌دست‌آمده با پارامترهای موقعیت مشخص‌شده در درخواست استفاده کنید
                        فهرست کامل موقعیت‌های موجود همراه با geo_id آن‌ها را اینجا ببینید یا درخواست جداگانه‌ای به https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations بفرستید
                        مثال:
                        US-NY

                      • geo_name
                        نوع: string | null

                        نام موقعیت
                        می‌توانید از این فیلد برای تطبیق نتایج به‌دست‌آمده با پارامترهای موقعیت مشخص‌شده در درخواست استفاده کنید
                        فهرست کامل موقعیت‌های موجود همراه با geo_name آن‌ها را اینجا ببینید یا درخواست جداگانه‌ای به https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations بفرستید
                        مثال:
                        Andorra

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

                        حاوی داده‌هایی درباره محبوبیت نسبی کلمات کلیدی بر اساس کشور یا منطقه است

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

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

                  • position
                    نوع: integer | null

                    ترازبندی عنصر
                    می‌تواند مقادیر زیر را داشته باشد: 1، 2، 3، 4 و غیره.

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

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

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

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

          • language_code
            نوع: string | null

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

          • location_code
            نوع: integer | null

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

          • type
            نوع: 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 post/v1/beta/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "rugby",
      "cricket"
    ],
    "date_from": "2023-01-01",
    "date_to": "2024-01-01",
    "type": "web",
    "location_name": "United States"
  }
]'

{
  "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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "interests": "[Max Depth Exceeded]",
              "interests_comparison": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

عملیات موفق

Setting Live ‘DataForSEO Trends Subregion Interests’ Tasks