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

Google Images SERP टास्क सेट करें

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

DataForSEO

​

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

Google Images SERP टास्क सेट करें

​

Google पर किसी कीवर्ड के लिए इमेज परिणाम कतार में डालता है और tasks[0].id में task id लौटाता है। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है। लाइव जुड़वाँ endpoint तुरंत उत्तर देता है और एकल क्वेरी के लिए सरल है; जब बैच एक टूल कॉल से अधिक समय ले तो कतार में डालें।

मूल्य संदर्भ

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

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

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

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

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

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

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

      अधिकतम मान: 700


      ऐसे प्रत्येक 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/{{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

    • pingback_url
      टाइप: string | null

      पूर्ण टास्क का नोटिफिकेशन URL

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

      जब कोई टास्क पूरा होता है, तो हम आपके द्वारा निर्दिष्ट URL पर भेजे गए GET request के माध्यम से आपको सूचित करेंगे

      आप ‘$id’ स्ट्रिंग को $id वेरिएबल के रूप में और ‘$tag’ को urlencoded $tag वेरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट कर देंगे।

      उदाहरण:

      http://your-server.com/pingscript?id=$id

      http://your-server.com/pingscript?id=$id&tag=$tag

      नोट: pingback_url में विशेष अक्षर urlencoded किए जाएँगे;

      अर्थात, # अक्षर %23 में एन्कोड किया जाएगा


      हमारे Help Center पर अधिक जानें

    • postback_data
      टाइप: string

      postback_url डेटाटाइप

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

      आपके सर्वर पर भेजे जाने वाले डेटाटाइप से मेल खाता है

      संभावित मान:

      advanced, html

    • postback_url
      टाइप: string | null

      टास्क परिणाम भेजने के लिए URL

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

      टास्क पूरा होने के बाद, हम gzip प्रारूप में संपीड़ित परिणामों के साथ एक POST request आपके द्वारा निर्दिष्ट postback_url पर भेजेंगे

      आप ‘$id’ स्ट्रिंग को $id वेरिएबल के रूप में और ‘$tag’ को urlencoded $tag वेरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट कर देंगे।

      उदाहरण:

      http://your-server.com/postbackscript?id=$id

      http://your-server.com/postbackscript?id=$id&tag=$tag

      नोट: postback_url में विशेष अक्षर urlencode किए जाएँगे;

      जैसे, # अक्षर %23 में एन्कोड हो जाएगा


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

    • priority
      टाइप: integer | null

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

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

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

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

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


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

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

    • 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_SerpGoogleImagesTaskPostResponseInfo
    • cost
      टाइप: number | null फ़ॉर्मेट: double

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

    • status_code
      टाइप: integer | null

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

    • status_message
      टाइप: string | null

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

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

      टास्क का ऐरे

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

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

        • data
          टाइप: object | null

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

          • propertyName
            टाइप: object | null
        • id
          टाइप: string | null

          टास्क आइडेंटिफ़ायर हमारे सिस्टम में अद्वितीय टास्क आइडेंटिफ़ायर, UUID प्रारूप में

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

          URL पथ

        • result
          टाइप: object | null

          परिणामों का ऐरे
          इस मामले में, मान 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/images/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/images/task_post \
  --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": null
    }
  ]
}
Setting Google Images SERP Tasks