Felo API PlatformFelo API Platform
تمام DataForSEO endpoints
v0.2.0-beta
OpenAPI 3.1.0

لائیو 'Bing Keyword Performance' ٹاسکس سیٹ کرنا

سرور:https://openapi.felo.ai
کلائنٹ لائبریریاں

DataForSEO

​

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

لائیو 'Bing Keyword Performance' ٹاسکس سیٹ کرنا

​

keywords کی کوئی فہرست دیے گئے device اور match قسم کے لیے Bing Ads میں کیسی کارکردگی دکھاتی ہے۔ ⚠️ language_name لازمی ہے اور اس کی عدم موجودگی HTTP 200 کے اندر Invalid Field: 'language_name' کے طور پر رپورٹ ہوتی ہے - یہ پیغام غائب ہونے اور غلط ہونے، دونوں کے لیے ہے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ درست جوڑے get_dataforseo_keywords_bing_kw_performance_locales سے آتے ہیں۔ اس endpoint کے submit اور fetch ہم منصب یہی کام async طریقے سے، اسی قیمت پر کرتے ہیں، ان بیچز کے لیے جو انتظار کے لیے بہت بڑے ہوں۔

قیمت کا حوالہ

  • میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
  • حوالہ جاتی درخواست کا تخمینہ: USD 0.09۔
  • حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔

صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔

باڈی
application/json
  • قسم: array (object | null)[]
    • device
      قسم: string | null

      ڈیوائس کی قسم
      اختیاری فیلڈ
      اگر آپ کسی مخصوص ڈیوائس کی قسم کے لیے ڈیٹا حاصل کرنا چاہتے ہیں تو یہ فیلڈ متعین کریں؛ ممکنہ اقدار: desktop, mobile, tablet, all
      ڈیفالٹ قدر: all

    • keywords
      قسم: array string[]

      کی ورڈز
      درکار فیلڈ
      آپ زیادہ سے زیادہ کتنے کی ورڈز متعین کر سکتے ہیں: 1000
      ہر کی ورڈ کے لیے زیادہ سے زیادہ حروف: 80
      ہر کی ورڈ فریز کے لیے زیادہ سے زیادہ الفاظ: 10
      متعین کردہ کی ورڈز کو لوئر کیس میں تبدیل کر دیا جائے گا، ڈیٹا الگ صف میں فراہم کیا جائے گا

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

    • language_code
      قسم: string

      سرچ انجن زبان کا کوڈ
      اگر آپ language_name متعین نہ کریں تو درکار فیلڈ
      آپ دستیاب مقامات اور زبانوں کی فہرست https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      "en"

    • language_name
      قسم: string

      سرچ انجن زبان کا پورا نام
      اگر آپ language_code متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو language_code متعین کرنے کی ضرورت نہیں
      آپ دستیاب مقامات اور زبانوں کی فہرست https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      English

    • location_code
      قسم: integer

      سرچ انجن مقام کا کوڈ
      اگر آپ location_name یا location_coordinate متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو location_name یا location_coordinate متعین کرنے کی ضرورت نہیں
      آپ دستیاب مقامات اور زبانوں کی فہرست https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      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 متعین کرنے کی ضرورت نہیں
      آپ دستیاب مقامات اور زبانوں کی فہرست https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      "United States"

    • match
      قسم: string | null

      کی ورڈز کا میچ ٹائپ
      اختیاری فیلڈ
      درج ذیل اقدار لے سکتا ہے:
      aggregate تمام میچ اقسام کا ڈیٹا واپس کرتا ہے؛
      broad متعین کی ورڈ پر مشتمل تمام صارف استفسارات کا ڈیٹا واپس کرتا ہے، الفاظ کی ترتیب بدلی ہوئی ہو سکتی ہے؛
      phrase متعین کی ورڈ پر مشتمل تمام صارف استفسارات کا ڈیٹا واپس کرتا ہے، الفاظ کی ترتیب یکساں ہونی چاہیے؛
      exact متعین کی ورڈ سے مطابقت رکھنے والے صارف استفسار کا ڈیٹا واپس کرتا ہے؛نوٹ: ڈیفالٹ طور پر aggregate میچ ٹائپ لاگو ہوتا ہے

    • tag
      قسم: string | null

      صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
      اختیاری فیلڈ
      حروف کی حد 255 ہے
      آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
      آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے

جوابات
  • 200
    قسم: object | null · Response36Afe1097B20_KeywordsDataBingKeywordPerformanceLiveResponseInfo
    • cost
      قسم: number | null فارمیٹ: double

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

    • status_code
      قسم: integer | null

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

    • status_message
      قسم: string | null

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

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

      ٹاسکس کی صف

      • قسم: object | null · Response36Afe1097B20_KeywordsDataBingKeywordPerformanceLiveTaskInfo
        • 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

          نتائج کی صف

          • keyword
            قسم: string | null

            POST صف میں کی ورڈ

          • keyword_kpi
            قسم: object | null · Response36Afe1097B20_KeywordKpi

            کی ورڈ میٹرکس پر مشتمل آبجیکٹ
            اگر ڈیٹا نہ ہو تو قدر is_nulln ہوتی ہے

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

              ڈیسک ٹاپ ڈیوائسز کے لیے مجموع شدہ کی ورڈ ڈیٹا
              اگر ڈیٹا نہ ہو تو قدر is_nulln ہوتی ہے

              • ad_position
                قسم: string | null

                SERP میں متعلقہ اشتہار کی پوزیشن کی نمائندگی کرتا ہے
                درج ذیل اقدار لے سکتا ہے:
                FirstPage1: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا پہلا اشتہار
                FirstPage2: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا دوسرا اشتہار
                FirstPage3: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا تیسرا اشتہار
                FirstPage4: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا چوتھا اشتہار
                FirstPage5: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا پانچواں اشتہار
                FirstPage6: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا چھٹا اشتہار
                FirstPage7: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا ساتواں اشتہار
                FirstPage8: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا آٹھواں اشتہار
                FirstPage9: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا نواں اشتہار
                FirstPage10: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا دسواں اشتہار
                MainLine1: سرچ نتائج صفحے کے اوپری حصے میں ظاہر ہونے والا پہلا اشتہار
                MainLine2: سرچ نتائج صفحے کے اوپری حصے میں ظاہر ہونے والا دوسرا اشتہار
                MainLine3: سرچ نتائج صفحے کے اوپری حصے میں ظاہر ہونے والا تیسرا اشتہار
                MainLine4: سرچ نتائج صفحے کے اوپری حصے میں ظاہر ہونے والا چوتھا اشتہار

              • average_bid
                قسم: number | null فارمیٹ: double

                کی ورڈ کی اوسط بولی

              • average_cpc
                قسم: number | null فارمیٹ: double

                اوسط فی کلک لاگت، USD
                تمام کلکس کی لاگت کو کلکس کی تعداد سے تقسیم کر کے شمار کیا جاتا ہے

              • clicks
                قسم: integer | null

                اشتہار کے کلکس
                پچھلے مہینے کے دوران کی ورڈ اور میچ ٹائپ نے جو کلکس پیدا کیے ان کی تعداد

              • ctr
                قسم: number | null فارمیٹ: double

                فیصد کے طور پر کلک تھرو ریٹ
                کلکس کی تعداد کو امپریشنز کی تعداد سے تقسیم کر کے اور نتیجے کو 100 سے ضرب دے کر شمار کیا جاتا ہے

              • impressions
                قسم: integer | null

                اشتہار کے امپریشنز
                پچھلے مہینے کے دوران کی ورڈ اور میچ ٹائپ نے جو امپریشنز پیدا کیے ان کی تعداد

              • total_cost
                قسم: number | null فارمیٹ: int64

                اشتہار کی کل لاگت، USD
                پچھلے مہینے کے دوران متعین کی ورڈ اور میچ ٹائپ استعمال کرنے کی لاگت

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

              موبائل ڈیوائسز کے لیے مجموع شدہ کی ورڈ ڈیٹا
              اگر ڈیٹا نہ ہو تو قدر is_nulln ہوتی ہے

              • ad_position
                قسم: string | null

                SERP میں متعلقہ اشتہار کی پوزیشن کی نمائندگی کرتا ہے
                درج ذیل اقدار لے سکتا ہے:
                FirstPage1: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا پہلا اشتہار
                FirstPage2: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا دوسرا اشتہار
                FirstPage3: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا تیسرا اشتہار
                FirstPage4: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا چوتھا اشتہار
                FirstPage5: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا پانچواں اشتہار
                FirstPage6: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا چھٹا اشتہار
                FirstPage7: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا ساتواں اشتہار
                FirstPage8: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا آٹھواں اشتہار
                FirstPage9: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا نواں اشتہار
                FirstPage10: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا دسواں اشتہار
                MainLine1: سرچ نتائج صفحے کے اوپری حصے میں ظاہر ہونے والا پہلا اشتہار
                MainLine2: سرچ نتائج صفحے کے اوپری حصے میں ظاہر ہونے والا دوسرا اشتہار
                MainLine3: سرچ نتائج صفحے کے اوپری حصے میں ظاہر ہونے والا تیسرا اشتہار
                MainLine4: سرچ نتائج صفحے کے اوپری حصے میں ظاہر ہونے والا چوتھا اشتہار

              • average_bid
                قسم: number | null فارمیٹ: double

                کی ورڈ کی اوسط بولی

              • average_cpc
                قسم: number | null فارمیٹ: double

                اوسط فی کلک لاگت، USD
                تمام کلکس کی لاگت کو کلکس کی تعداد سے تقسیم کر کے شمار کیا جاتا ہے

              • clicks
                قسم: integer | null

                اشتہار کے کلکس
                پچھلے مہینے کے دوران کی ورڈ اور میچ ٹائپ نے جو کلکس پیدا کیے ان کی تعداد

              • ctr
                قسم: number | null فارمیٹ: double

                فیصد کے طور پر کلک تھرو ریٹ
                کلکس کی تعداد کو امپریشنز کی تعداد سے تقسیم کر کے اور نتیجے کو 100 سے ضرب دے کر شمار کیا جاتا ہے

              • impressions
                قسم: integer | null

                اشتہار کے امپریشنز
                پچھلے مہینے کے دوران کی ورڈ اور میچ ٹائپ نے جو امپریشنز پیدا کیے ان کی تعداد

              • total_cost
                قسم: number | null فارمیٹ: int64

                اشتہار کی کل لاگت، USD
                پچھلے مہینے کے دوران متعین کی ورڈ اور میچ ٹائپ استعمال کرنے کی لاگت

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

              ٹیبلٹ ڈیوائسز کے لیے مجموع شدہ کی ورڈ ڈیٹا
              اگر ڈیٹا نہ ہو تو قدر is_nulln ہوتی ہے

              • ad_position
                قسم: string | null

                SERP میں متعلقہ اشتہار کی پوزیشن کی نمائندگی کرتا ہے
                درج ذیل اقدار لے سکتا ہے:
                FirstPage1: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا پہلا اشتہار
                FirstPage2: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا دوسرا اشتہار
                FirstPage3: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا تیسرا اشتہار
                FirstPage4: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا چوتھا اشتہار
                FirstPage5: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا پانچواں اشتہار
                FirstPage6: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا چھٹا اشتہار
                FirstPage7: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا ساتواں اشتہار
                FirstPage8: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا آٹھواں اشتہار
                FirstPage9: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا نواں اشتہار
                FirstPage10: پہلے سرچ نتائج صفحے کے دائیں جانب ظاہر ہونے والا دسواں اشتہار
                MainLine1: سرچ نتائج صفحے کے اوپری حصے میں ظاہر ہونے والا پہلا اشتہار
                MainLine2: سرچ نتائج صفحے کے اوپری حصے میں ظاہر ہونے والا دوسرا اشتہار
                MainLine3: سرچ نتائج صفحے کے اوپری حصے میں ظاہر ہونے والا تیسرا اشتہار
                MainLine4: سرچ نتائج صفحے کے اوپری حصے میں ظاہر ہونے والا چوتھا اشتہار

              • average_bid
                قسم: number | null فارمیٹ: double

                کی ورڈ کی اوسط بولی

              • average_cpc
                قسم: number | null فارمیٹ: double

                اوسط فی کلک لاگت، USD
                تمام کلکس کی لاگت کو کلکس کی تعداد سے تقسیم کر کے شمار کیا جاتا ہے

              • clicks
                قسم: integer | null

                اشتہار کے کلکس
                پچھلے مہینے کے دوران کی ورڈ اور میچ ٹائپ نے جو کلکس پیدا کیے ان کی تعداد

              • ctr
                قسم: number | null فارمیٹ: double

                فیصد کے طور پر کلک تھرو ریٹ
                کلکس کی تعداد کو امپریشنز کی تعداد سے تقسیم کر کے اور نتیجے کو 100 سے ضرب دے کر شمار کیا جاتا ہے

              • impressions
                قسم: integer | null

                اشتہار کے امپریشنز
                پچھلے مہینے کے دوران کی ورڈ اور میچ ٹائپ نے جو امپریشنز پیدا کیے ان کی تعداد

              • total_cost
                قسم: number | null فارمیٹ: int64

                اشتہار کی کل لاگت، USD
                پچھلے مہینے کے دوران متعین کی ورڈ اور میچ ٹائپ استعمال کرنے کی لاگت

          • language_code
            قسم: string | null

            POST صف میں زبان کا کوڈ
            اگر ڈیٹا نہ ہو تو قدر null ہوتی ہے

          • location_code
            قسم: integer | null

            POST صف میں لوکیشن کوڈ
            اگر ڈیٹا نہ ہو تو قدر null ہوتی ہے

          • month
            قسم: integer | null

            وہ مہینہ بتاتا ہے جس کے لیے ڈیٹا فراہم کیا گیا ہے
            مثال:
            10

          • year
            قسم: integer | null

            وہ سال بتاتا ہے جس کے لیے ڈیٹا فراہم کیا گیا ہے
            مثال:
            2020

        • 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/bing/keyword_performance/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/keyword_performance/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_code": "en",
    "keywords": [
      "dataforseo",
      "seo",
      "ranking"
    ]
  }
]'
{
  "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,
          "year": null,
          "month": null,
          "keyword_kpi": {
            "desktop": [
              "[Max Depth Exceeded]"
            ],
            "mobile": [
              "[Max Depth Exceeded]"
            ],
            "tablet": [
              "[Max Depth Exceeded]"
            ]
          }
        }
      ]
    }
  ]
}
Setting Live ‘Bing Keyword Performance’ Tasks