Felo API PlatformFelo API Platform
تمام DataForSEO endpoints
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۔

قیمت کا حوالہ

  • میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
  • حوالہ جاتی درخواست کا تخمینہ: USD 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 علامات، ایموجی) سے گریز کریں؛
      غیر لاطینی حروف متعین کرنے پر آپ کو ان ممالک کا ڈیٹا ملے گا جہاں وہ استعمال ہوتے ہیں

      DataForSEO APIs میں keyword اور keywords فیلڈز کے قواعد اور پابندیوں کے بارے میں اس Help Center مضمون میں مزید جانیں

    • 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 ہے
      آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
      آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے

    • 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

      ٹاسکس کی کل لاگت، USD

    • status_code
      قسم: integer | null

      عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

    • status_message
      قسم: string | null

      عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے

    • tasks
      قسم: array (object | null)[] | null

      ٹاسکس کی صف

      • قسم: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveTaskInfo
        • cost
          قسم: number | null فارمیٹ: double

          ٹاسکس کی کل لاگت، USD

        • 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

    درست Felo API کلید درکار ہے۔

  • 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