लाइव Google Images SERP

Felo API Support

MIT

सर्वर

https://openapi.felo.ai

क्लाइंट लाइब्रेरी

Shell Curl

DataForSEO

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

DataForSEO ऑपरेशन

post/v1/beta/dataforseo/serp/google/images/live/advanced

लाइव Google Images 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)[]
- depth
  टाइप: integer | null
  
  पार्सिंग गहराई
  
  वैकल्पिक फ़ील्ड
  
  SERP में परिणामों की संख्या
  
  डिफ़ॉल्ट मान: 100
  
  अधिकतम मान: 200
  
  ऐसे प्रत्येक SERP के लिए आपके खाते से बिल लिया जाएगा जिसमें अधिकतम 100 परिणाम हों;
  100 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन 100 से अधिक परिणाम लौटाता है;
  
  यदि निर्दिष्ट गहराई 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/google/languages पर अलग request भेजकर प्राप्त कर सकते हैं
  
  उदाहरण:
  
  en
- language_name
  टाइप: string
  
  सर्च इंजन भाषा का पूरा नाम
  
  language_code निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_code निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप language_name-सह सर्च इंजन की उपलब्ध भाषाओं की सूची https://api.dataforseo.com/v3/serp/google/languages पर अलग request भेजकर प्राप्त कर सकते हैं
  
  उदाहरण:
  
  English
- location_code
  टाइप: integer
  
  सर्च इंजन स्थान कोड
  
  आवश्यक फ़ील्ड यदि आप location_name या location_coordinate निर्दिष्ट नहीं करते
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप location_code-सह सर्च इंजनों के उपलब्ध स्थानों की सूची https://api.dataforseo.com/v3/serp/google/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/google/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
  
  सर्च क्वेरी के अतिरिक्त पैरामीटर
  
  वैकल्पिक फ़ील्ड
  
  उपलब्ध पैरामीटर की सूची और अतिरिक्त विवरण यहाँ प्राप्त करें।
- tag
  टाइप: string | null
  
  उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
  
  वैकल्पिक फ़ील्ड
  
  अक्षर सीमा 255 है
  
  आप इस पैरामीटर का उपयोग टास्क की पहचान करने और उसे परिणाम से मिलाने के लिए कर सकते हैं
  
  आप निर्दिष्ट tag मान response के data ऑब्जेक्ट में पाएँगे
- 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_SerpGoogleImagesLiveAdvancedResponseInfo
cost
टाइप: number | null फ़ॉर्मेट: double

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

status_code
टाइप: integer | null

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

status_message
टाइप: string | null

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

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

टास्क का ऐरे

टाइप: object | null · Response36Afe1097B20_SerpGoogleImagesLiveAdvancedTaskInfo
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) के प्रकार शामिल हैं।
संभावित आइटम प्रकार:
carousel, images_search, related_searches

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

तत्व के आइटम

rank_absolute
टाइप: integer | null

लक्ष्य डोमेन के लिए SERP में पूर्ण रैंक
SERP के सभी तत्वों में पूर्ण स्थिति

rank_group
टाइप: integer | null

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

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

post/v1/beta/dataforseo/serp/google/images/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/images/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

स्कीमा दिखाएँ

{
  "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,
              "xpath": null
            }
          ]
        }
      ]
    }
  ]
}

सफल ऑपरेशन

लाइव Google Images SERP

प्रमाणीकरणRequired

DataForSEO

लाइव Google Images SERP

मूल्य संदर्भ