DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
लाइव Google AI Mode SERP
किसी क्वेरी के लिए Google का AI Mode उत्तर उन स्रोतों के साथ सिंक्रोनस रूप से लौटाता है जिन्हें वह 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 लौटाता है।
मूल्य संदर्भ
- मीटरिंग: सफल request के निश्चित लागत आधार पर
- संदर्भ request अनुमान: USD 0.004
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array (object | null)[]
- browserटाइप: integer | null
_screen _height ब्राउज़र स्क्रीन ऊँचाई
वैकल्पिक फ़ील्ड
किसी विशेष डिवाइस के लिए पिक्सेल रैंकिंग की गणना हेतु आप कस्टम ब्राउज़र स्क्रीन ऊँचाई सेट कर सकते हैं;
निम्न श्रेणी में निर्दिष्ट की जा सकती है:
240-9999;डिफ़ॉल्ट रूप से, पैरामीटर इस पर सेट है:
desktopके लिए1080;androidपरmobileके लिए640;iOSपरmobileके लिए812;नोट: इस पैरामीटर का उपयोग करने के लिए,
calculate_rectanglesकोtrueपर सेट करें - browserटाइप: integer | null
_screen _resolution _ratio ब्राउज़र स्क्रीन रिज़ॉल्यूशन अनुपात
वैकल्पिक फ़ील्ड
किसी विशेष डिवाइस के लिए पिक्सेल रैंकिंग की गणना हेतु आप कस्टम ब्राउज़र स्क्रीन रिज़ॉल्यूशन अनुपात सेट कर सकते हैं;
निम्न श्रेणी में निर्दिष्ट किया जा सकता है:
0.5-3;डिफ़ॉल्ट रूप से, पैरामीटर इस पर सेट है:
desktopके लिए1;androidपरmobileके लिए3;iOSपरmobileके लिए3;नोट: इस पैरामीटर का उपयोग करने के लिए,
calculate_rectanglesकोtrueपर सेट करें - browserटाइप: integer | null फ़ॉर्मेट: int64
_screen _width ब्राउज़र स्क्रीन चौड़ाई
वैकल्पिक फ़ील्ड
किसी विशेष डिवाइस के लिए पिक्सेल रैंकिंग की गणना हेतु आप कस्टम ब्राउज़र स्क्रीन चौड़ाई सेट कर सकते हैं;
निम्न श्रेणी में निर्दिष्ट की जा सकती है:
240-9999;डिफ़ॉल्ट रूप से, पैरामीटर इस पर सेट है:
desktopके लिए1920;androidपरmobileके लिए360;iOSपरmobileके लिए375;नोट: इस पैरामीटर का उपयोग करने के लिए,
calculate_rectanglesकोtrueपर सेट करें - calculateटाइप: boolean | null
_rectangles उन्नत परिणामों में 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टाइप: string
_code सर्च इंजन भाषा कोड
आवश्यक फ़ील्ड यदि आप निर्दिष्ट नहीं करते
language_name;यदि आप यह फ़ील्ड उपयोग करते हैं, तो
language_nameनिर्दिष्ट करने की आवश्यकता नहीं है;आप
https://api.dataforseo.com/v3/serp/google/ai_mode/languagesपर अलग request भेजकरlanguage_codeके साथ सर्च इंजन की उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैं - languageटाइप: string
_name सर्च इंजन भाषा का पूरा नाम
आवश्यक फ़ील्ड यदि आप निर्दिष्ट नहीं करते
language_code;यदि आप यह फ़ील्ड उपयोग करते हैं, तो
language_codeनिर्दिष्ट करने की आवश्यकता नहीं है;आप
https://api.dataforseo.com/v3/serp/google/ai_mode/languagesपर अलग request भेजकरlanguage_nameके साथ सर्च इंजन की उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैं; - locationटाइप: integer
_code सर्च इंजन स्थान कोड
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टाइप: string
_coordinate स्थान के 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टाइप: string
_name सर्च इंजन स्थान का पूरा नाम
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 - tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
वैकल्पिक फ़ील्ड
अक्षर सीमा 255 है
आप इस पैरामीटर का उपयोग टास्क की पहचान करने और उसे परिणाम से मिलाने के लिए कर सकते हैं
आप निर्दिष्ट
tagमान response केdataऑब्जेक्ट में पाएँगे
- टाइप: object | null · Response36Afe1097B20_SerpGoogleAiModeLiveAdvancedResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_SerpGoogleAiModeLiveAdvancedTaskInfo
- costटाइप: number | null फ़ॉर्मेट: double
टास्क की कुल लागत, USD
- dataटाइप: object | null
इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे
- propertyटाइप: object | null
Name
- idटाइप: string | null
टास्क आइडेंटिफ़ायर हमारे सिस्टम में अद्वितीय टास्क आइडेंटिफ़ायर, UUID प्रारूप में
- pathटाइप: array (string | null)[] | null
URL पथ
- resultटाइप: array (object | null)[] | null
परिणामों का ऐरे
- checkटाइप: string | null
_url सर्च इंजन परिणामों का सीधा URL
आप इसका उपयोग यह सुनिश्चित करने के लिए कर सकते हैं कि हमने सटीक परिणाम दिए हैं - datetimeटाइप: string | null
वह तारीख और समय जब परिणाम प्राप्त हुआ
UTC प्रारूप में: “yyyy-mm-dd hh-mm-ss +00:00”
उदाहरण:2019-11-15 12:57:46 +00:00 - itemटाइप: array (string | null)[] | null
_types SERP में सर्च परिणामों के प्रकार
SERP में मिले सर्च परिणामों (items) के प्रकार शामिल हैं।
संभावित आइटम प्रकार:ai_overview - itemsटाइप: array (object | null)[] | null
तत्व के आइटम
- itemsटाइप: array (object | null)[] | null
तत्व में मौजूद आइटम
- positionटाइप: string | null
SERP में तत्व का संरेखण
यह निम्न मान ले सकता है:left,right - typeटाइप: string | null
एलिमेंट का प्रकार
- markdownटाइप: string | null
- pageटाइप: integer | null
SERP पेज
वह SERP पेज जिस पर तत्व रैंक करता है - positionटाइप: string | null
SERP में तत्व का संरेखण
यह निम्न मान ले सकता है:left,right - rankटाइप: integer | null
_absolute SERP में पूर्ण रैंक
SERP के सभी तत्वों में पूर्ण स्थिति - rankटाइप: integer | null
_group SERP में समूह रैंक
समानtypeमान वाले तत्वों के समूह के भीतर स्थिति
भिन्नtypeमान वाले तत्वों की स्थितियाँrank_groupसे बाहर रखी जाती हैं - 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-अक्ष निर्देशांक, जहाँ स्क्रीन का ऊपरी बाएँ कोना मूल बिंदु है
- referencesटाइप: array (object | null)[] | null
आइटम से संबंधित अतिरिक्त संदर्भ
उन वेबपेजों के संदर्भ शामिल हैं जिनका उपयोगai_overviewबनाने के लिए किया गया हो सकता है- domainटाइप: string | null
रेफ़रेंस का डोमेन नाम
- positionटाइप: string | null
SERP में तत्व का संरेखण
यह निम्न मान ले सकता है:left,right - sourceटाइप: string | null
रेफ़रेंस स्रोत का नाम या शीर्षक
- textटाइप: string | null
कंपोनेंट का टेक्स्ट
- titleटाइप: string | null
लिंक एंकर टेक्स्ट
- typeटाइप: string | null
एलिमेंट का प्रकार
- urlटाइप: string | null
लिंक URL
- typeटाइप: string | null
एलिमेंट का प्रकार
- xpathटाइप: string | null
- itemsटाइप: integer | null फ़ॉर्मेट: int64
_count itemsऐरे में लौटाए गए परिणामों की संख्या - keywordटाइप: string | null
POST ऐरे में प्राप्त कीवर्ड
कीवर्ड डिकोड किए गए %## के साथ लौटाया जाता है ('+' चिह्न एक स्पेस वर्ण में डिकोड होगा) - languageटाइप: string | null
_code POST ऐरे में भाषा कोड
- locationटाइप: integer | null
_code POST ऐरे में स्थान कोड
- refinementटाइप: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips सर्च रिफ़ाइनमेंट चिप्स
इस मामले में, मानnullहोगा- 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टाइप: string | null
_domain POST ऐरे में सर्च इंजन डोमेन
- seटाइप: integer | null फ़ॉर्मेट: int64
_results _count SERP में परिणामों की कुल संख्या
- spellटाइप: object | null · Response36Afe1097B20_SpellInfo
सर्च इंजन का ऑटोकरेक्शन
यदि सर्च इंजन ने किसी सुधारे गए कीवर्ड के लिए परिणाम दिए हैं, तो हम सर्च इंजन द्वारा सुधारा गया कीवर्ड और ऑटोकरेक्शन का प्रकार बताएँगे;
इस मामले में, मानnullहोगा- 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टाइप: integer | null फ़ॉर्मेट: int64
_count result ऐरे में एलिमेंट की संख्या
- statusटाइप: integer | null
_code टास्क का स्टेटस कोड DataForSEO द्वारा जनरेट किया गया, यह निम्न श्रेणी में हो सकता है: 10000-60000 response कोड की पूरी सूची यहाँ देखी जा सकती है
- statusटाइप: string | null
_message टास्क का सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- timeटाइप: string | null
निष्पादन समय, सेकंड
- टाइप: integer | null फ़ॉर्मेट: int64tasks
_count tasks ऐरे में टास्क की संख्या
- टाइप: integer | null फ़ॉर्मेट: int64tasks
_error त्रुटि के साथ लौटाए गए tasks ऐरे में टास्क की संख्या
- टाइप: string | nulltime
कुल निष्पादन समय, सेकंड
- टाइप: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/live/advanced \
--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": [
{
"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,
"page": null,
"position": null,
"xpath": null,
"markdown": null,
"items": [
"[Max Depth Exceeded]"
],
"references": [
"[Max Depth Exceeded]"
],
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}