Felo API PlatformFelo API Platform
सभी DataForSEO endpoint
v0.2.0-beta
OpenAPI 3.1.0

लाइव Google News SERP

सर्वर:https://openapi.felo.ai
क्लाइंट लाइब्रेरी

DataForSEO

​

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

लाइव Google News SERP

​

Google पर किसी कीवर्ड के रैंक किए गए परिणाम सिंक्रोनस रूप से लौटाता है। keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count और items लौटाता है। advanced डिफ़ॉल्ट विकल्प है; जब केवल रैंक की गई सूची मायने रखे तो regular लें और केवल यह जाँचने के लिए कि पार्सर ने क्या छोड़ा, html लें। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है।

मूल्य संदर्भ

  • मीटरिंग: रिपोर्ट किया गया response लागत
  • संदर्भ request अनुमान: USD 0.02
  • संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।

यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।

बॉडी
application/json
  • टाइप: array (object | null)[]
    • browser_screen_height
      टाइप: integer | null

      ब्राउज़र स्क्रीन ऊँचाई

      वैकल्पिक फ़ील्ड

      किसी विशेष डिवाइस के लिए पिक्सेल रैंकिंग की गणना हेतु आप कस्टम ब्राउज़र स्क्रीन ऊँचाई सेट कर सकते हैं;

      डिफ़ॉल्ट रूप से, पैरामीटर 1080 पर सेट है;

      नोट: इस पैरामीटर का उपयोग करने के लिए, calculate_rectangles को true पर सेट करें

    • browser_screen_resolution_ratio
      टाइप: integer | null

      ब्राउज़र स्क्रीन रिज़ॉल्यूशन अनुपात

      वैकल्पिक फ़ील्ड

      किसी विशेष डिवाइस के लिए पिक्सेल रैंकिंग की गणना हेतु आप कस्टम ब्राउज़र स्क्रीन रिज़ॉल्यूशन अनुपात सेट कर सकते हैं;

      डिफ़ॉल्ट रूप से, पैरामीटर 1 पर सेट है;

      नोट: इस पैरामीटर का उपयोग करने के लिए, calculate_rectangles को true पर सेट करें

    • browser_screen_width
      टाइप: integer | null फ़ॉर्मेट: int64

      ब्राउज़र स्क्रीन चौड़ाई

      वैकल्पिक फ़ील्ड

      किसी विशेष डिवाइस के लिए पिक्सेल रैंकिंग की गणना हेतु आप कस्टम ब्राउज़र स्क्रीन चौड़ाई सेट कर सकते हैं;

      डिफ़ॉल्ट रूप से, पैरामीटर 1920 पर सेट है;

      नोट: इस पैरामीटर का उपयोग करने के लिए, calculate_rectangles को true पर सेट करें

    • calculate_rectangles
      टाइप: boolean | null

      उन्नत परिणामों में SERP तत्वों के लिए पिक्सेल रैंकिंग की गणना करें

      वैकल्पिक फ़ील्ड

      पिक्सेल रैंकिंग परिणाम स्निपेट और स्क्रीन के ऊपरी बाएँ कोने के बीच की दूरी को दर्शाती है;

      अधिक जानने के लिए Help Center पर जाएँ>>

      डिफ़ॉल्ट रूप से, पैरामीटर false पर सेट है

      नोट: यदि true पर सेट है, तो प्रति टास्क शुल्क 2 गुना हो जाएगा

    • depth
      टाइप: integer | null

      पार्सिंग गहराई

      वैकल्पिक फ़ील्ड

      SERP में परिणामों की संख्या

      डिफ़ॉल्ट मान: 10

      अधिकतम मान: 200


      आपके खाते से प्रत्येक ऐसे SERP के लिए बिल लिया जाएगा जिसमें अधिकतम 10 परिणाम हों;

      10 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन 10 से अधिक परिणाम लौटाता है;

      यदि निर्दिष्ट गहराई response में परिणामों की संख्या से अधिक है, तो अंतर स्वचालित रूप से आपके खाता शेष में वापस कर दिया जाएगा

      लागत की गणना Pricing पेज पर की जा सकती है।

    • keyword
      टाइप: string

      कीवर्ड

      आवश्यक फ़ील्ड

      आप अधिकतम 700 अक्षर keyword फ़ील्ड में निर्दिष्ट कर सकते हैं

      सभी %## डिकोड किए जाएँगे ('+' अक्षर एक स्पेस अक्षर में डिकोड होगा)

      यदि आप अपने keyword के लिए "%" अक्षर का उपयोग करना चाहते हैं, तो इसे "%25" के रूप में निर्दिष्ट करें;

      यदि आप अपने keyword के लिए “+” अक्षर का उपयोग करना चाहते हैं, तो इसे “%2B” के रूप में निर्दिष्ट करें;

      यदि इस फ़ील्ड में 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:' जैसे पैरामीटर हैं, तो प्रति टास्क शुल्क 5 गुना हो जाएगा

      नोट: ‘cache:’ पैरामीटर वाली क्वेरीज़ समर्थित नहीं हैं और validation error लौटाएँगी


      DataForSEO API में keyword और keywords फ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में अधिक जानें

    • language_code
      टाइप: string

      सर्च इंजन भाषा कोड

      language_name निर्दिष्ट न करने पर आवश्यक फ़ील्ड

      यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_name निर्दिष्ट करने की आवश्यकता नहीं है

      आप language_code  के साथ सर्च इंजन की उपलब्ध भाषाओं की सूची https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages पर अलग request भेजकर प्राप्त कर सकते हैं

      उदाहरण:

      en

    • language_name
      टाइप: string

      सर्च इंजन भाषा का पूरा नाम

      language_code निर्दिष्ट न करने पर आवश्यक फ़ील्ड

      यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_code निर्दिष्ट करने की आवश्यकता नहीं है

      आप language_name के साथ सर्च इंजन की उपलब्ध भाषाओं की सूची https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages पर अलग request भेजकर प्राप्त कर सकते हैं

      उदाहरण:

      English

    • location_code
      टाइप: integer

      सर्च इंजन स्थान कोड

      location_name या location_coordinate निर्दिष्ट न करने पर आवश्यक फ़ील्ड

      यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है

      आप location_code के साथ सर्च इंजनों के उपलब्ध स्थानों की सूची https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations पर अलग request भेजकर प्राप्त कर सकते हैं

      उदाहरण:

      2840

    • location_coordinate
      टाइप: string

      किसी स्थान के GPS निर्देशांक

      location_name या location_code निर्दिष्ट न करने पर आवश्यक फ़ील्ड

      यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_code निर्दिष्ट करने की आवश्यकता नहीं है

      location_coordinate पैरामीटर "latitude,longitude,radius" प्रारूप में निर्दिष्ट करना चाहिए

      "latitude" और "longitude" के लिए दशमलव अंकों की अधिकतम संख्या: 7

      "radius" के लिए न्यूनतम मान: 199.9 (mm)

      "radius" के लिए अधिकतम मान: 199999 (mm)

      उदाहरण:

      53.476225,-2.243572,200

    • location_name
      टाइप: string

      सर्च इंजन स्थान का पूरा नाम

      location_code या location_coordinate निर्दिष्ट न करने पर आवश्यक फ़ील्ड

      यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_code या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है

      आप location_name-सह सर्च इंजन के उपलब्ध स्थानों की सूची https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations पर अलग request भेजकर प्राप्त कर सकते हैं

      उदाहरण:

      London,England,United Kingdom

    • max_crawl_pages
      टाइप: integer | null

      पेज क्रॉल सीमा

      वैकल्पिक फ़ील्ड

      क्रॉल किए जाने वाले सर्च परिणाम पेजों की संख्या

      अधिकतम मान: 100

      नोट: max_crawl_pages और depth पैरामीटर एक-दूसरे के पूरक हैं;

      हमारे Help Center पर और जानें

    • os
      टाइप: string | null

      डिवाइस ऑपरेटिंग सिस्टम

      वैकल्पिक फ़ील्ड

      ध्यान दें कि यह API केवल डेस्कटॉप के लिए परिणाम देता है

      निम्न मानों में से चुनें: windows, macos

      डिफ़ॉल्ट मान: windows

    • se_domain
      टाइप: string | null

      सर्च इंजन डोमेन

      वैकल्पिक फ़ील्ड

      हम आपके द्वारा निर्दिष्ट स्थान और भाषा के अनुसार प्रासंगिक सर्च इंजन डोमेन स्वचालित रूप से चुनते हैं

      हालाँकि, आप इस फ़ील्ड में कस्टम सर्च इंजन डोमेन सेट कर सकते हैं

      उदाहरण:

      google.co.uk, google.com.au, google.de, आदि

    • search_param
      टाइप: string | null

      सर्च क्वेरी के अतिरिक्त पैरामीटर

      वैकल्पिक फ़ील्ड

      उपलब्ध पैरामीटरों की सूची और अतिरिक्त विवरण यहाँ प्राप्त करें।

    • url
      टाइप: string | null

      सर्च क्वेरी का सीधा URL

      वैकल्पिक फ़ील्ड

      आप सीधा URL निर्दिष्ट कर सकते हैं और हम इसे आवश्यक फ़ील्ड में वर्गीकृत कर देंगे। ध्यान दें कि यह विधि हमारे API के लिए संसाधित करने में सबसे कठिन है और इसके लिए URL में सटीक भाषा और स्थान निर्दिष्ट करना भी आवश्यक है। अधिकांश मामलों में, हम इस विधि का उपयोग करने की सलाह नहीं देते।

      उदाहरण:

      https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS

responses
  • 200
    टाइप: object | null · Response36Afe1097B20_SerpGoogleNewsLiveAdvancedResponseInfo
    • cost
      टाइप: number | null फ़ॉर्मेट: double

      टास्क की कुल लागत, USD

    • status_code
      टाइप: integer | null

      सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है

    • status_message
      टाइप: string | null

      सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है

    • tasks
      टाइप: array (object | null)[] | null

      टास्क का ऐरे

      • टाइप: object | null · Response36Afe1097B20_SerpGoogleNewsLiveAdvancedTaskInfo
        • cost
          टाइप: number | null फ़ॉर्मेट: double

          टास्क की कुल लागत, USD

        • data
          टाइप: object | null

          इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे

          • 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

          • includes_non_news_search_results
            टाइप: boolean | null

            दर्शाता है कि रिस्पॉन्स में समाचार सामग्री के अतिरिक्त गैर-समाचार सर्च परिणाम भी हैं या नहीं

          • item_types
            टाइप: array (string | null)[] | null

            SERP में सर्च परिणामों के प्रकार
            SERP में मिले सर्च परिणामों (items) के प्रकार शामिल हैं।
            संभावित आइटम प्रकार:
            top_stories, news_search

          • items
            टाइप: array (object | null)[] | null

            तत्व के आइटम

            • rank_absolute
              टाइप: integer | null

              SERP में निरपेक्ष रैंक
              SERP में सभी तत्वों के बीच निरपेक्ष स्थिति

            • rank_group
              टाइप: integer | null

              SERP में समूह रैंक
              समान type मान वाले तत्वों के समूह के भीतर स्थिति
              भिन्न type मान वाले तत्वों की स्थितियाँ rank_group से बाहर रखी जाती हैं

            • rectangle
              टाइप: object | null · Response36Afe1097B20_AiModeRectangleInfo

              आयत पैरामीटर
              SERP में परिणाम के स्निपेट के कार्टीशियन निर्देशांक और पिक्सेल आयाम शामिल हैं
              null के बराबर यदि POST request में calculate_rectangles को true पर सेट न किया गया हो

              • height
                टाइप: number | null फ़ॉर्मेट: double

                तत्व की ऊँचाई पिक्सेल में

              • width
                टाइप: number | null फ़ॉर्मेट: double

                तत्व की चौड़ाई पिक्सेल में

              • x
                टाइप: number | null फ़ॉर्मेट: double

                x-अक्ष निर्देशांक परिणाम स्निपेट के ऊपरी बाएँ कोने का x-अक्ष निर्देशांक, जहाँ स्क्रीन का ऊपरी बाएँ कोना मूल बिंदु है

              • y
                टाइप: number | null फ़ॉर्मेट: double

                y-अक्ष निर्देशांक परिणाम स्निपेट के ऊपरी बाएँ कोने का y-अक्ष निर्देशांक, जहाँ स्क्रीन का ऊपरी बाएँ कोना मूल बिंदु है

            • title
              टाइप: string | null

              तत्व का शीर्षक

            • 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

            सर्च रिफ़ाइनमेंट चिप्स

            • 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

            सर्च इंजन का ऑटोकरेक्शन
            यदि सर्च इंजन ने किसी सुधारे गए कीवर्ड के लिए परिणाम दिए हैं, तो हम सर्च इंजन द्वारा सुधारा गया कीवर्ड और ऑटोकरेक्शन का प्रकार बताएँगे

            • 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 response कोड की पूरी सूची यहाँ देखी जा सकती है

        • 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

    request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।

  • 401

    एक वैध Felo API key आवश्यक है।

  • 402

    request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।

  • 403

    खाते को यह ऑपरेशन करने की अनुमति नहीं है।

  • 429

    request या खर्च की सीमा तक पहुँच गए हैं।

  • 502

    सेवा request पूरा नहीं कर सकी।

  • 503

    API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।

  • 504

    request संसाधित करते समय सेवा का समय समाप्त हो गया।

  • default

    त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।

    application/json
Request Example for post/v1/beta/dataforseo/serp/google/news/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/news/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "android"
  }
]'
{
  "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]"
            ]
          },
          "includes_non_news_search_results": null,
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "xpath": null,
              "title": null,
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Live Google News SERP