Google AI Mode 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/ai_mode/task_post

Google AI Mode SERP टास्क सेट करना

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

मूल्य संदर्भ

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

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

बॉडी

application/json

टाइप: array (object | null)[]
- browser_screen_height
  टाइप: integer | null
  
  ब्राउज़र स्क्रीन ऊँचाई
  
  वैकल्पिक फ़ील्ड
  
  किसी विशेष डिवाइस के लिए पिक्सेल रैंकिंग की गणना हेतु आप कस्टम ब्राउज़र स्क्रीन ऊँचाई सेट कर सकते हैं;
  
  निम्न श्रेणी में निर्दिष्ट की जा सकती है: 240-9999;
  
  डिफ़ॉल्ट रूप से, पैरामीटर इस पर सेट है:
  
  desktop के लिए 1080;
  
  android पर mobile के लिए 640;
  
  iOS पर mobile के लिए 812;
  
  नोट: इस पैरामीटर का उपयोग करने के लिए, calculate_rectangles को true पर सेट करें
- browser_screen_resolution_ratio
  टाइप: integer | null
  
  ब्राउज़र स्क्रीन रिज़ॉल्यूशन अनुपात
  
  वैकल्पिक फ़ील्ड
  
  किसी विशेष डिवाइस के लिए पिक्सेल रैंकिंग की गणना हेतु आप कस्टम ब्राउज़र स्क्रीन रिज़ॉल्यूशन अनुपात सेट कर सकते हैं;
  
  निम्न श्रेणी में निर्दिष्ट किया जा सकता है: 0.5-3;
  
  डिफ़ॉल्ट रूप से, पैरामीटर इस पर सेट है:
  
  desktop के लिए 1;
  
  android पर mobile के लिए 3;
  
  iOS पर mobile के लिए 3;
  
  नोट: इस पैरामीटर का उपयोग करने के लिए, calculate_rectangles को true पर सेट करें
- browser_screen_width
  टाइप: integer | null फ़ॉर्मेट: int64
  
  ब्राउज़र स्क्रीन चौड़ाई
  
  वैकल्पिक फ़ील्ड
  
  किसी विशेष डिवाइस के लिए पिक्सेल रैंकिंग की गणना हेतु आप कस्टम ब्राउज़र स्क्रीन चौड़ाई सेट कर सकते हैं;
  
  निम्न श्रेणी में निर्दिष्ट की जा सकती है: 240-9999;
  
  डिफ़ॉल्ट रूप से, पैरामीटर इस पर सेट है:
  
  desktop के लिए 1920;
  
  android पर mobile के लिए 360;
  
  iOS पर mobile के लिए 375;
  
  नोट: इस पैरामीटर का उपयोग करने के लिए, calculate_rectangles को true पर सेट करें
- calculate_rectangles
  टाइप: boolean | null
  
  उन्नत परिणामों में SERP तत्वों के लिए पिक्सेल रैंकिंग की गणना करें
  
  वैकल्पिक फ़ील्ड
  
  पिक्सेल रैंकिंग परिणाम स्निपेट और स्क्रीन के ऊपरी बाएँ कोने के बीच की दूरी को दर्शाती है;
  
  अधिक जानने के लिए Help Center पर जाएँ>>
  
  डिफ़ॉल्ट रूप से, पैरामीटर false पर सेट है
  
  नोट: यदि true पर सेट है, तो प्रति टास्क शुल्क 2 गुना हो जाएगा
- 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 निर्दिष्ट करने की आवश्यकता नहीं है;
  
  आप https://api.dataforseo.com/v3/serp/google/ai_mode/languages पर अलग request भेजकर language_code के साथ सर्च इंजन की उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैं
- language_name
  टाइप: string
  
  सर्च इंजन भाषा का पूरा नाम
  
  आवश्यक फ़ील्ड यदि आप निर्दिष्ट नहीं करते language_code;
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_code निर्दिष्ट करने की आवश्यकता नहीं है;
  
  आप https://api.dataforseo.com/v3/serp/google/ai_mode/languages पर अलग request भेजकर language_name के साथ सर्च इंजन की उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैं;
- location_code
  टाइप: integer
  
  सर्च इंजन स्थान कोड
  
  location_name या location_coordinate निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप location_code के साथ सर्च इंजनों के उपलब्ध स्थानों की सूची https://api.dataforseo.com/v3/serp/google/locations पर अलग request भेजकर प्राप्त कर सकते हैं
  
  नोट: AI Mode वर्तमान में किन देशों में उपलब्ध है, उसकी सूची के लिए Google Search Help देखें
- 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,18z
- location_name
  टाइप: string
  
  सर्च इंजन स्थान का पूरा नाम
  
  location_code या location_coordinate निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_code या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप location_name के साथ सर्च इंजन के उपलब्ध स्थानों की सूची https://api.dataforseo.com/v3/serp/google/locations पर अलग request भेजकर प्राप्त कर सकते हैं
  
  नोट: AI Mode वर्तमान में किन देशों में उपलब्ध है, उसकी सूची के लिए Google Search Help देखें
- os
  टाइप: string | null
  
  डिवाइस ऑपरेटिंग सिस्टम
  
  वैकल्पिक फ़ील्ड
  
  यदि आप device फ़ील्ड में desktop निर्दिष्ट करते हैं, तो निम्न में से चुनें: windows, macos
  
  डिफ़ॉल्ट मान: windows
  
  यदि आप device फ़ील्ड में mobile निर्दिष्ट करते हैं, तो निम्न में से चुनें: android, ios
  
  डिफ़ॉल्ट मान: android
- 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 पेज पर गणना की जा सकती है।
- tag
  टाइप: string | null
  
  उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
  
  वैकल्पिक फ़ील्ड
  
  अक्षर सीमा 255 है
  
  आप इस पैरामीटर का उपयोग टास्क की पहचान करने और उसे परिणाम से मिलाने के लिए कर सकते हैं
  
  आप निर्दिष्ट tag मान response के data ऑब्जेक्ट में पाएँगे

responses

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

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

status_code
टाइप: integer | null

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

status_message
टाइप: string | null

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

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

टास्क का ऐरे

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

post/v1/beta/dataforseo/serp/google/ai_mode/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "what is google ai mode"
  }
]'

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

{
  "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
    }
  ]
}

सफल ऑपरेशन

Google AI Mode SERP टास्क सेट करना

प्रमाणीकरणRequired

DataForSEO

Google AI Mode SERP टास्क सेट करना

मूल्य संदर्भ