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

لائیو Google AI Mode SERP

Felo API Support
MIT
سرور:https://openapi.felo.ai
کلائنٹ لائبریریاں
Shell Curl

DataForSEO

​

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

DataForSEO آپریشنز

لائیو Google AI Mode SERP

​

Google پر کسی کوئری کے لیے Google کا AI Mode جواب، ان ذرائع کے ساتھ جن کا وہ Google پر حوالہ دیتا ہے، ہم وقت واپس کرتا ہے۔ keyword، type، se_domain، location_code، language_code، check_url، datetime، spell، refinement_chips، item_types، items_count اور items واپس کرتا ہے۔ advanced ڈیفالٹ انتخاب ہے؛ regular تب لیں جب صرف درجہ بند فہرست اہم ہو، اور html صرف یہ دیکھنے کے لیے کہ پارسر نے کیا چھوڑا۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔

قیمت کا حوالہ

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

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

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

      براؤزر اسکرین کی اونچائی

      اختیاری فیلڈ

      آپ کسی مخصوص ڈیوائس کے لیے پکسل رینکنگ شمار کرنے کے لیے حسب ضرورت براؤزر اسکرین کی اونچائی سیٹ کر سکتے ہیں؛

      یہ درج ذیل حد میں متعین کی جا سکتی ہے: 240-9999؛

      بطور ڈیفالٹ پیرامیٹر یہ ہے:

      1080 برائے desktop؛

      640 برائے mobile on android؛

      812 برائے mobile on iOS؛

      نوٹ: یہ پیرامیٹر استعمال کرنے کے لیے calculate_rectangles کو true پر سیٹ کریں

    • browser_screen_resolution_ratio
      قسم: integer | null

      براؤزر اسکرین ریزولوشن کا تناسب

      اختیاری فیلڈ

      آپ کسی مخصوص ڈیوائس کے لیے پکسل رینکنگ شمار کرنے کے لیے حسب ضرورت براؤزر اسکرین ریزولوشن کا تناسب سیٹ کر سکتے ہیں؛

      یہ درج ذیل حد میں متعین کیا جا سکتا ہے: 0.5-3؛

      بطور ڈیفالٹ پیرامیٹر یہ ہے:

      1 برائے desktop؛

      3 برائے mobile on android؛

      3 برائے mobile on iOS؛

      نوٹ: یہ پیرامیٹر استعمال کرنے کے لیے calculate_rectangles کو true پر سیٹ کریں

    • browser_screen_width
      قسم: integer | null فارمیٹ: int64

      براؤزر اسکرین کی چوڑائی

      اختیاری فیلڈ

      آپ کسی مخصوص ڈیوائس کے لیے پکسل رینکنگ شمار کرنے کے لیے حسب ضرورت براؤزر اسکرین کی چوڑائی سیٹ کر سکتے ہیں؛

      یہ درج ذیل حد میں متعین کی جا سکتی ہے: 240-9999؛

      بطور ڈیفالٹ پیرامیٹر یہ ہے:

      1920 برائے desktop؛

      360 برائے mobile on android؛

      375 برائے mobile on iOS؛

      نوٹ: یہ پیرامیٹر استعمال کرنے کے لیے calculate_rectangles کو true پر سیٹ کریں

    • calculate_rectangles
      قسم: boolean | null

      ایڈوانسڈ نتائج میں SERP عناصر کے لیے پکسل رینکنگ شمار کریں

      اختیاری فیلڈ

      پکسل رینکنگ سے مراد نتیجے کے اسنیپٹ اور اسکرین کے اوپری بائیں کونے کے درمیان فاصلہ ہے؛

      مزید جاننے کے لیے Help Center ملاحظہ کریں>>

      بطور ڈیفالٹ، پیرامیٹر false پر سیٹ ہوتا ہے

      نوٹ: اگر true پر سیٹ کیا جائے تو ہر ٹاسک کا چارج 2 گنا بڑھ جائے گا

    • device
      قسم: string | null

      ڈیوائس کی قسم

      اختیاری فیلڈ

      مخصوص ڈیوائس کی قسم کے لیے نتائج واپس کریں

      یہ اقدار لے سکتا ہے: desktop، mobile

      ڈیفالٹ قدر: desktop

    • keyword
      قسم: string

      کی ورڈ

      درکار فیلڈ

      آپ keyword فیلڈ میں زیادہ سے زیادہ 700 حروف متعین کر سکتے ہیں

      تمام %## ڈی کوڈ ہوں گے (نیز ‘+’ حرف خالی جگہ کے حرف میں ڈی کوڈ ہوگا)

      اگر آپ کو اپنے keyword کے لیے “%” حرف استعمال کرنا ہو تو اسے “%25” کے طور پر متعین کریں؛

      اگر آپ کو اپنے keyword کے لیے “+” حرف استعمال کرنا ہو تو اسے “%2B” کے طور پر متعین کریں


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

    • language_code
      قسم: string

      سرچ انجن زبان کا کوڈ

      اگر آپ language_name متعین نہ کریں تو درکار فیلڈ؛

      اگر آپ یہ فیلڈ استعمال کریں تو آپ کو language_name متعین کرنے کی ضرورت نہیں؛

      آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے language_code کے ساتھ https://api.dataforseo.com/v3/serp/google/ai_mode/languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں

    • language_name
      قسم: string

      سرچ انجن زبان کا پورا نام

      اگر آپ language_code متعین نہ کریں تو درکار فیلڈ؛

      اگر آپ یہ فیلڈ استعمال کریں تو آپ کو language_code متعین کرنے کی ضرورت نہیں؛

      آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے language_name کے ساتھ https://api.dataforseo.com/v3/serp/google/ai_mode/languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں؛

    • location_code
      قسم: integer

      سرچ انجن مقام کا کوڈ

      اگر آپ متعین نہ کریں تو درکار فیلڈ location_name یا location_coordinate

      اگر آپ یہ فیلڈ استعمال کریں تو location_name یا location_coordinate متعین کرنے کی ضرورت نہیں

      آپ سرچ انجنز کے دستیاب مقامات کی فہرست ان کے location_code کے ساتھ الگ درخواست بھیج کر حاصل کر سکتے ہیں https://api.dataforseo.com/v3/serp/google/locations

      نوٹ: AI Mode فی الوقت کن ممالک میں دستیاب ہے اس کی فہرست کے لیے Google Search Help دیکھیں

    • location_coordinate
      قسم: string

      مقام کے GPS نقاط

      اگر آپ متعین نہ کریں تو درکار فیلڈ location_name یا location_code

      اگر آپ یہ فیلڈ استعمال کریں تو location_name یا location_code متعین کرنے کی ضرورت نہیں

      location_coordinate پیرامیٹر "latitude,longitude,zoom" کی شکل میں متعین کرنا چاہیے

      اگر "zoom" متعین نہ ہو تو ڈیفالٹ کے طور پر 9z لاگو ہوگا

      "latitude" اور "longitude" کے لیے اعشاریے ہندسوں کی زیادہ سے زیادہ تعداد: 7

      "zoom" کی کم سے کم قدر: 4z

      "zoom" کی زیادہ سے زیادہ قدر: 18z

      مثال:

      52.6178549,-155.352142,18z

    • location_name
      قسم: string

      سرچ انجن مقام کا پورا نام

      اگر آپ متعین نہ کریں تو درکار فیلڈ location_code یا location_coordinate

      اگر آپ یہ فیلڈ استعمال کریں تو location_code یا location_coordinate متعین کرنے کی ضرورت نہیں

      آپ سرچ انجن کے دستیاب مقامات کی فہرست ان کے location_name کے ساتھ الگ درخواست بھیج کر حاصل کر سکتے ہیں https://api.dataforseo.com/v3/serp/google/locations

      نوٹ: AI Mode فی الوقت کن ممالک میں دستیاب ہے اس کی فہرست کے لیے Google Search Help دیکھیں

    • os
      قسم: string | null

      ڈیوائس آپریٹنگ سسٹم

      اختیاری فیلڈ

      اگر آپ desktop کو device فیلڈ میں متعین کریں تو درج ذیل اقدار میں سے انتخاب کریں: windows، macos

      ڈیفالٹ قدر: windows

      اگر آپ mobile کو device فیلڈ میں متعین کریں تو درج ذیل اقدار میں سے انتخاب کریں: android، ios

      ڈیفالٹ قدر: android

    • tag
      قسم: string | null

      صارف کی متعین کردہ ٹاسک شناخت

      اختیاری فیلڈ

      حروف کی حد 255 ہے

      آپ اس پیرامیٹر کو ٹاسک کی شناخت اور اسے نتیجے سے ملانے کے لیے استعمال کر سکتے ہیں

      آپ کو متعین کردہ tag قدر جواب کے data آبجیکٹ میں ملے گی

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

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

    • status_code
      قسم: integer | null

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

    • status_message
      قسم: string | null

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

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

      ٹاسکس کی صف

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

          نتائج کی صف

          • check_url
            قسم: string | null

            سرچ انجن نتائج کا براہ راست URL
            آپ اسے یقینی بنانے کے لیے استعمال کر سکتے ہیں کہ ہم نے عین مطابق نتائج فراہم کیے ہیں

          • datetime
            قسم: string | null

            وہ تاریخ اور وقت جب نتیجہ موصول ہوا
            UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”
            مثال:
            2019-11-15 12:57:46 +00:00

          • item_types
            قسم: array (string | null)[] | null

            SERP میں تلاش کے نتائج کی اقسام
            SERP میں پائے جانے والے تلاش کے نتائج (items) کی اقسام شامل ہیں۔
            ممکنہ آئٹم اقسام:
            ai_overview

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

            عنصر کے آئٹمز

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

              عنصر میں موجود آئٹمز

              • position
                قسم: string | null

                SERP میں عنصر کی سیدھ
                درج ذیل قدریں لے سکتا ہے:
                left, right

              • type
                قسم: string | null

                عنصر کی قسم

            • markdown
              قسم: string | null

              مارک ڈاؤن فارمیٹ میں عنصر کا مواد
              ai_overview کا متن جو مارک ڈاؤن مارک اپ زبان میں فارمیٹ کیا گیا ہے

            • page
              قسم: integer | null

              SERP صفحہ
              وہ SERP صفحہ جس پر عنصر درجہ رکھتا ہے

            • position
              قسم: string | null

              SERP میں عنصر کی سیدھ
              درج ذیل قدریں لے سکتا ہے:
              left, right

            • rank_absolute
              قسم: integer | null

              SERP میں مطلق درجہ
              SERP کے تمام عناصر کے درمیان مطلق پوزیشن

            • rank_group
              قسم: integer | null

              SERP میں گروپ رینک
              یکساں type اقدار والے عناصر کے گروپ کے اندر پوزیشن
              مختلف type اقدار والے عناصر کی پوزیشنز rank_group سے خارج ہوتی ہیں

            • rectangle
              قسم: object | null · Response36Afe1097B20_AiModeRectangleInfo

              مستطیل پیرامیٹرز
              SERP میں نتیجے کے اسنیپٹ کے کارٹیزین کوآرڈینیٹس اور پکسل طول و عرض رکھتا ہے
              اگر POST درخواست میں calculate_rectangles کو true پر سیٹ نہ کیا گیا ہو تو null کے برابر ہوتا ہے

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

                عنصر کی اونچائی پکسلز میں

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

                عنصر کی چوڑائی پکسلز میں

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

                x-axis کوآرڈینیٹ نتیجے کے اسنیپٹ کے اوپری بائیں کونے کا x-axis کوآرڈینیٹ، جہاں اسکرین کا اوپری بائیں کونا نقطۂ مبدا ہے

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

                y-axis کوآرڈینیٹ نتیجے کے اسنیپٹ کے اوپری بائیں کونے کا y-axis کوآرڈینیٹ، جہاں اسکرین کا اوپری بائیں کونا نقطۂ مبدا ہے

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

              آئٹم سے متعلقہ اضافی حوالہ جات
              ان ویب صفحات کے حوالہ جات شامل ہیں جو ai_overview تیار کرنے کے لیے استعمال ہوئے ہوں

              • domain
                قسم: string | null

                حوالے کا ڈومین نام

              • position
                قسم: string | null

                SERP میں عنصر کی سیدھ
                درج ذیل قدریں لے سکتا ہے:
                left, right

              • source
                قسم: string | null

                حوالے کے ماخذ کا نام یا عنوان

              • text
                قسم: string | null

                کمپوننٹ کا متن

              • title
                قسم: string | null

                لنک کا اینکر متن

              • type
                قسم: string | null

                عنصر کی قسم

              • url
                قسم: string | null

                لنک URL

            • type
              قسم: string | null

              عنصر کی قسم

            • xpath
              قسم: string | null

              عنصر کا XPath

          • items_count
            قسم: integer | null فارمیٹ: int64

            items صف میں واپس کیے گئے نتائج کی تعداد

          • keyword
            قسم: string | null

            POST صف میں موصول ہونے والا کی ورڈ
            کی ورڈ ڈی کوڈ شدہ %## کے ساتھ واپس کیا جاتا ہے (پلس سمبل '+' اسپیس کریکٹر میں ڈی کوڈ ہو جائے گا)

          • language_code
            قسم: string | null

            POST صف میں زبان کا کوڈ

          • location_code
            قسم: integer | null

            POST صف میں مقام کا کوڈ

          • refinement_chips
            قسم: object | null · Response36Afe1097B20_RefinementChipsInfo

            تلاش کی باریکی کے چپس
            اس صورت میں قدر null ہوگی

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

              عنصر کے آئٹمز

              • domain
                قسم: string | null

                SERP میں ڈومین

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

                مزید تلاش کی باریکی کے مزید اختیارات

                • domain
                  قسم: string | null

                  SERP میں ڈومین

                • title
                  قسم: string | null

                  عنصر کا عنوان

                • type
                  قسم: string | null

                  عنصر کی قسم

                • url
                  قسم: string | null

                  ریفائنمنٹ پیرامیٹرز کے ساتھ تلاش کا URL

              • title
                قسم: string | null

                عنصر کا عنوان

              • type
                قسم: string | null

                عنصر کی قسم

              • url
                قسم: string | null

                ریفائنمنٹ پیرامیٹرز کے ساتھ تلاش کا URL

            • type
              قسم: string | null

              عنصر کی قسم

            • xpath
              قسم: string | null

              عنصر کا XPath

          • se_domain
            قسم: string | null

            POST صف میں سرچ انجن کا ڈومین

          • se_results_count
            قسم: integer | null فارمیٹ: int64

            SERP میں نتائج کی کل تعداد

          • spell
            قسم: object | null · Response36Afe1097B20_SpellInfo

            سرچ انجن کی خودکار تصحیح
            اگر سرچ انجن نے کسی ایسے کی ورڈ کے لیے نتائج فراہم کیے جو درست کیا گیا تھا، تو ہم سرچ انجن کی درست کردہ کی ورڈ اور خودکار تصحیح کی قسم بتائیں گے؛
            اس صورت میں قدر null ہوگی

            • keyword
              قسم: string | null

              سرچ انجن کی خودکار تصحیح کے نتیجے میں حاصل کردہ کی ورڈ نتائج درست کیے گئے کی ورڈ کے لیے فراہم کیے جائیں گے

            • type
              قسم: string | null

              خودکار تصحیح کی قسم ممکنہ اقدار: did_you_mean, showing_results_for, no_results_found_for, including_results_for نوٹ: Yahoo اور Yandex صرف درج ذیل خودکار تصحیح کی قسم معاون کرتے ہیں: including_results_for

          • 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/serp/google/ai_mode/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "what is google ai mode"
  }
]'

{
  "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,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "page": null,
              "position": null,
              "xpath": null,
              "markdown": null,
              "items": [
                "[Max Depth Exceeded]"
              ],
              "references": [
                "[Max Depth Exceeded]"
              ],
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

کامیاب آپریشن

Live Google AI Mode SERP