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

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

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 Demography’ زنده

​

مخاطبان Google Trends پشت یک کلیدواژه: تفکیک سن و جنسیت در همان پنجره‌ای که post_dataforseo_keywords_trends_explore_live استفاده می‌کند، با همان آرگومان‌های type و تاریخ. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. مانند همزادش ارزان است. برای «کجا» به‌جای «چه کسی»، از post_dataforseo_keywords_trends_subregion_interests_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_KeywordsDataDataforseoTrendsDemographyLiveResponseInfo
    • cost
      نوع: number | null قالب: double

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

    • status_code
      نوع: integer | null

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

    • status_message
      نوع: string | null

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

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

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

      • نوع: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsDemographyLiveTaskInfo
        • 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_DataforseoTrendsDemographyElementItem
                • نوع: object · Response36Afe1097B20_DataforseoTrendsDemographyElementItem
                  • type
                    تمایزدهنده
                    نوع: string | null

                    نوع عنصر

                  • demography
                    نوع: object | null · Response36Afe1097B20_Demography

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

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

                      توزیع محبوبیت کلیدواژه بر اساس سن

                      • keyword
                        نوع: string | null

                        کلیدواژه مرتبطی که داده‌های جمعیت‌شناختی برای آن ارائه شده است

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

                        شامل بازه سنی و مقادیر محبوبیت کلیدواژه متناظر است

                        • type
                          نوع: string | null

                          نوع عنصر

                        • value
                          نوع: integer | null

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

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

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

                      • keyword
                        نوع: string | null

                        کلیدواژه مرتبطی که داده‌های جمعیت‌شناختی برای آن ارائه شده است

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

                        شامل بازه سنی و مقادیر محبوبیت کلیدواژه متناظر است

                        • type
                          نوع: string | null

                          نوع عنصر

                        • value
                          نوع: integer | null

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

                  • demography_comparison
                    نوع: object | null · Response36Afe1097B20_DemographyComparisonInfo

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

                    • age
                      نوع: object | null

                      نوع عنصر

                      • propertyName
                        نوع: array (integer | null)[] | null
                    • gender
                      نوع: object | null

                      نوع عنصر

                      • propertyName
                        نوع: array (integer | 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/demography/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/demography/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]",
              "demography": "[Max Depth Exceeded]",
              "demography_comparison": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

عملیات موفق

Setting Live ‘DataForSEO Trends Demography’ Tasks