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

Google Search By Image SERP टास्क सेट करना

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

DataForSEO

​

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

Google Search By Image SERP टास्क सेट करना

​

किसी image URL के लिए Google जो पेज ढूँढता है, उन्हें कतार में डालता है, और tasks[0].id में task id लौटाता है। 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 गुना हो जाएगा

    • image_url
      टाइप: string

      छवि का URL

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

      परिणाम इस फ़ील्ड में आपके द्वारा निर्दिष्ट छवि पर आधारित होंगे

      उदाहरण:

      https://upload.wikimedia.org/wikipedia/commons/e/ed/Elon_Musk_Royal_Society.jpg

    • 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 पर

    • 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 ऑब्जेक्ट में पाएँगे

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

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

    • status_code
      टाइप: integer | null

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

    • status_message
      टाइप: string | null

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

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

      टास्क का ऐरे

      • टाइप: object | null · Response36Afe1097B20_SerpGoogleSearchByImageTaskPostTaskInfo
        • 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/search_by_image/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/search_by_image/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "image_url": "https://dataforseo.com/wp-content/uploads/2016/11/data_for_seo_light_429.png"
  }
]'
{
  "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 Search By Image SERP Tasks