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

लाइव Google Local Finder 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 Local Finder SERP

​

सिंक्रोनस रूप से Google पर स्पष्ट रूप से स्थानीय क्वेरी के लिए 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)[]
    • depth
      टाइप: integer | null

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

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

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

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

      अधिकतम मान: 100


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

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

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

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

    • device
      टाइप: string | null

      डिवाइस प्रकार

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

      किसी विशेष डिवाइस प्रकार के लिए परिणाम लौटाएँ

      यह निम्न मान ले सकता है:desktop, mobile

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

    • keyword
      टाइप: string

      कीवर्ड

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

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

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

      यदि आपको keyword में “%” उपयोग करना है, तो उसे “%25” के रूप में निर्दिष्ट करें;

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


      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,zoom" प्रारूप में निर्दिष्ट किया जाना चाहिए

      यदि "zoom" निर्दिष्ट नहीं है, तो डिफ़ॉल्ट मान के रूप में 9z लागू होगा

      "latitude" और "longitude" के लिए अधिकतम दशमलव अंक: 7

      "zoom" के लिए न्यूनतम मान: 4z

      "zoom" के लिए अधिकतम मान: 18z

      उदाहरण:

      52.6178549,-155.352142,20z

    • 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

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

      न्यूनतम रेटिंग के आधार पर परिणाम फ़िल्टर करें

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

      desktop के लिए संभावित मान: 3.5, 4, 4.5;

      mobile के लिए संभावित मान: 2, 2.5, 3, 3.5, 4, 4.5

    • os
      टाइप: string | null

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

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

      यदि आप device फ़ील्ड में desktop निर्दिष्ट करते हैं, तो निम्न में से चुनें: windows, macos

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

      यदि आप device फ़ील्ड में mobile निर्दिष्ट करते हैं, तो निम्न में से चुनें: android, ios

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

    • priority
      टाइप: integer | null

      टास्क प्राथमिकता

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

      निम्नलिखित मान ले सकता है:

      1 – सामान्य निष्पादन प्राथमिकता (डिफ़ॉल्ट रूप से सेट)

      2 – उच्च निष्पादन प्राथमिकता


      उच्च निष्पादन प्राथमिकता वाले टास्क के लिए आपसे अतिरिक्त शुल्क लिया जाएगा।

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

    • tag
      टाइप: string | null

      उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर

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

      अक्षर सीमा 255 है

      आप इस पैरामीटर का उपयोग टास्क की पहचान करने और उसे परिणाम से मिलाने के लिए कर सकते हैं

      आप निर्दिष्ट tag मान response के data ऑब्जेक्ट में पाएँगे

    • time_filter
      टाइप: string | null

      खुलने के समय के आधार पर परिणाम फ़िल्टर करें

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

      इस फ़ील्ड का उपयोग करके आप परिणामों में स्थानों को उस समय के आधार पर फ़िल्टर कर सकते हैं जब वह स्थान आगंतुकों के लिए खुला होता है

      ध्यान दें कि Google ऐसे परिणाम भी दे सकता है जो इस फ़िल्टर से मेल नहीं खाते

      संभावित मान: "open_now", "24_hours", "$day_value", "$day_value;$time_value";

      $day_value के स्थान पर इनमें से कोई एक मान उपयोग करें: "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday";

      $time_value के स्थान पर इनमें से कोई एक मान उपयोग करें: "00", "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23"

      उदाहरण: "tuesday;18"

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

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

    • status_code
      टाइप: integer | null

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

    • status_message
      टाइप: string | null

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

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

      टास्क का ऐरे

      • टाइप: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveAdvancedTaskInfo
        • 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

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

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

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

            तत्व के आइटम

            • टाइप: object | null · Response36Afe1097B20_LocalPackSerpElementItem
                • टाइप: object · Response36Afe1097B20_LocalPackSerpElementItem
                  • type
                    डिस्क्रिमिनेटर
                    टाइप: string | null

                    एलिमेंट का प्रकार

                  • booking_url
                    टाइप: string | null

                    बुकिंग पेज का URL

                  • cid
                    टाइप: string | null

                    Google द्वारा परिभाषित क्लाइंट id

                  • description
                    टाइप: string | null

                    लिंक का विवरण

                  • domain
                    टाइप: string | null

                    वीडियो होस्ट करने वाली वेबसाइट का डोमेन

                  • is_paid
                    टाइप: boolean | null

                    दर्शाता है कि तत्व एक विज्ञापन है या नहीं

                  • page
                    टाइप: integer | null

                    सर्च परिणाम पेज संख्या
                    उस SERP पेज की संख्या दर्शाता है जिस पर तत्व स्थित है

                  • phone
                    टाइप: string | null

                    फ़ोन नंबर

                  • position
                    टाइप: string | null

                    SERP में तत्व का संरेखण
                    यह निम्न मान ले सकता है:
                    left, right

                  • rank_absolute
                    टाइप: integer | null

                    SERP में पूर्ण रैंक
                    SERP के सभी तत्वों में पूर्ण स्थिति
                    हमेशा 0 के बराबर होता है desktop के लिए

                  • rank_group
                    टाइप: integer | null

                    SERP में समूह रैंक
                    समान type मान वाले तत्वों के समूह में स्थिति;
                    भिन्न type मान वाले तत्वों की स्थितियाँ rank_group से बाहर रहती हैं;
                    हमेशा 0 के बराबर होता है desktop के लिए

                  • rating
                    टाइप: object | null · Response36Afe1097B20_RatingInfo

                    तत्व की रेटिंग
                    समीक्षाओं के आधार पर लोकप्रियता दर जो SERP में दिखाई जाती है;
                    यदि कोई नहीं है, तो null के बराबर

                    • rating_max
                      टाइप: integer | null

                      rating_type के लिए अधिकतम मान

                    • rating_type
                      टाइप: string | null

                      रेटिंग का प्रकार यहाँ आपको निम्नलिखित तत्व मिलेंगे: Max5, Percents, CustomMax

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

                      रेटिंग का मान

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

                      फ़ीडबैक की मात्रा

                  • 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

                    पंक्ति का शीर्षक

                  • url
                    टाइप: string | null

                    तृतीय-पक्ष समीक्षा स्रोत का URL

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

{
  "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": "[Max Depth Exceeded]",
              "page": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "xpath": "[Max Depth Exceeded]",
              "rectangle": "[Max Depth Exceeded]",
              "rank_group": "[Max Depth Exceeded]",
              "rank_absolute": "[Max Depth Exceeded]",
              "title": "[Max Depth Exceeded]",
              "description": "[Max Depth Exceeded]",
              "domain": "[Max Depth Exceeded]",
              "phone": "[Max Depth Exceeded]",
              "booking_url": "[Max Depth Exceeded]",
              "url": "[Max Depth Exceeded]",
              "is_paid": "[Max Depth Exceeded]",
              "rating": "[Max Depth Exceeded]",
              "cid": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

सफल ऑपरेशन

Live Google Local Finder SERP