DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
लाइव Yahoo Organic SERP Regular
Yahoo पर किसी कीवर्ड के रैंक किए गए परिणाम सिंक्रोनस रूप से लौटाता है। keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count और items लौटाता है। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट किया गया response लागत
- संदर्भ request अनुमान: USD 0.02
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array (object | null)[]
- depthटाइप: integer | null
- deviceटाइप: string | null
डिवाइस प्रकार
वैकल्पिक फ़ील्ड
मान ले सकता है:desktop,mobile
डिफ़ॉल्ट मान:desktop - keywordटाइप: string
कीवर्ड
आवश्यक फ़ील्ड
आपkeywordफ़ील्ड में अधिकतम 700 अक्षर निर्दिष्ट कर सकते हैं
सभी %## डिकोड किए जाएँगे ('+' अक्षर एक स्पेस अक्षर में डिकोड होगा)
यदि आपको अपनेkeywordके लिए "%" अक्षर का उपयोग करना है, तो उसे "%25" के रूप में निर्दिष्ट करें;
यदि आपको अपनेkeywordके लिए “+” अक्षर का उपयोग करना है, तो उसे “%2B” के रूप में निर्दिष्ट करेंDataForSEO APIs में
keywordऔरkeywordsफ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में और जानें - languageटाइप: string
_code सर्च इंजन भाषा कोड
language_nameनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlanguage_nameनिर्दिष्ट करने की आवश्यकता नहीं है
आपlanguage_codeके साथ सर्च इंजन की उपलब्ध भाषाओं की सूचीhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesपर अलग request भेजकर प्राप्त कर सकते हैं
उदाहरण:en - languageटाइप: string
_name सर्च इंजन भाषा का पूरा नाम
language_codeनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlanguage_codeनिर्दिष्ट करने की आवश्यकता नहीं है
आपlanguage_nameके साथ सर्च इंजन की उपलब्ध भाषाओं की सूचीhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesपर अलग request भेजकर प्राप्त कर सकते हैं
उदाहरण:English - locationटाइप: integer
_code सर्च इंजन स्थान कोड
आवश्यक फ़ील्ड यदि आप निर्दिष्ट नहीं करतेlocation_nameयाlocation_coordinate
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlocation_nameयाlocation_coordinateनिर्दिष्ट करने की आवश्यकता नहीं है
आपhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsपर अलग request भेजकरlocation_codeके साथ सर्च इंजन के उपलब्ध स्थानों की सूची प्राप्त कर सकते हैं
उदाहरण:2840 - locationटाइप: string
_coordinate स्थान के 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टाइप: string
_name सर्च इंजन स्थान का पूरा नाम
आवश्यक फ़ील्ड यदि आप निर्दिष्ट नहीं करतेlocation_codeयाlocation_coordinate
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlocation_codeयाlocation_coordinateनिर्दिष्ट करने की आवश्यकता नहीं है
आपhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsपर अलग request भेजकरlocation_nameके साथ सर्च इंजन के उपलब्ध स्थानों की सूची प्राप्त कर सकते हैं
उदाहरण:London,England,United Kingdom - maxटाइप: integer | null
_crawl _pages - osटाइप: string | null
डिवाइस ऑपरेटिंग सिस्टम
वैकल्पिक फ़ील्ड
यदिdeviceफ़ील्ड मेंdesktopनिर्दिष्ट है, तो निम्न में से चुनें:windows,macos
डिफ़ॉल्ट मान:windows
यदिdeviceफ़ील्ड मेंmobileनिर्दिष्ट है, तो निम्न में से चुनें:android,ios
डिफ़ॉल्ट मान:android - seटाइप: string | null
_domain सर्च इंजन डोमेन
वैकल्पिक फ़ील्ड
हम आपके द्वारा निर्दिष्ट स्थान और भाषा के अनुसार प्रासंगिक सर्च इंजन डोमेन स्वचालित रूप से चुनते हैं
हालाँकि, आप इस फ़ील्ड में कस्टम सर्च इंजन डोमेन सेट कर सकते हैं
उदाहरण:au.search.yahoo.com,uk.search.yahoo.com,ca.search.yahoo.com, आदि। - searchटाइप: string | null
_param सर्च क्वेरी के अतिरिक्त पैरामीटर
वैकल्पिक फ़ील्ड
उपलब्ध पैरामीटर की सूची और अतिरिक्त विवरण यहाँ प्राप्त करें - stopटाइप: array (object | null)[] | null
_crawl _on _match क्रॉलिंग रोकने के लिए टार्गेट का ऐरे वैकल्पिक फ़ील्ड यदि निर्दिष्ट किया जाए, तो response में निर्दिष्ट match_value तक और उसके सहित SERP परिणाम होंगे; आप इस ऐरे में अधिकतम 10 टार्गेट मान निर्दिष्ट कर सकते हैं उदाहरण: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] इस पैरामीटर के बारे में हमारे Help Center पर और जानें - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api आपके खाते से निर्दिष्ट टार्गेट के माध्यम से क्रॉल किए गए प्रत्येक SERP के लिए बिल लिया जाएगा
- matchटाइप: string | null
_type टार्गेट मैच प्रकार stop_crawl_on_match निर्दिष्ट होने पर आवश्यक फ़ील्ड; match_value के लिए मैच का प्रकार संभावित मान: domain, with_subdomains, wildcard
- matchटाइप: string | null
_value टार्गेट डोमेन या वाइल्डकार्ड मान stop_crawl_on_match निर्दिष्ट होने पर आवश्यक फ़ील्ड; टार्गेट डोमेन या वाइल्डकार्ड मान निर्दिष्ट करें; नोट: डोमेन नाम request प्रोटोकॉल के बिना निर्दिष्ट करना होगा; उदाहरण: dataforseo.com
- tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
वैकल्पिक फ़ील्ड
अक्षर सीमा 255 है
आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
निर्दिष्टtagमान response केdataऑब्जेक्ट में मिलेगा - targetटाइप: string | null
वह लक्ष्य डोमेन, सबडोमेन या पेज जिसके लिए परिणाम प्राप्त करने हैं
वैकल्पिक फ़ील्ड
डोमेन या सबडोमेनhttps://औरwww.के बिना निर्दिष्ट करना चाहिए
ध्यान दें किtargetवाले टास्क के परिणामों में केवल वे SERP तत्व शामिल होंगे जिनमेंurlस्ट्रिंग है;
आप SERP में खोज पैटर्न निर्दिष्ट करने और परिणामों को सीमित करने के लिए वाइल्डकार्ड (‘’) का भी उपयोग कर सकते हैं;
उदाहरण:example.com- उस वेबसाइट के होमपेज के परिणाम लौटाता है जिसका URLhttps://example.comयाhttps://www.example.com/याhttps://example.com/जैसा है;example.com- डोमेन के परिणाम लौटाता है, जिसमें उसके सभी पेज शामिल हैं;example.com- पूरे डोमेन के परिणाम लौटाता है, जिसमें उसके सभी पेज और सबडोमेन शामिल हैं;example.com- सबडोमेन की परवाह किए बिना होमपेज के परिणाम लौटाता है, जैसेhttps://en.example.com;example.com/example-page- सटीक URL के परिणाम लौटाता है;example.com/example-page- डोमेन के उन सभी URL के परिणाम लौटाता है जो निर्दिष्ट स्ट्रिंग से शुरू होते हैं - urlटाइप: string | null
सीधा खोज URL
वैकल्पिक फ़ील्ड
आप सीधा URL निर्दिष्ट कर सकते हैं और हम उसे आवश्यक फ़ील्ड में पार्स करेंगे। ध्यान दें कि यह तरीका हमारे API के लिए संसाधित करना सबसे कठिन है और इसके लिए URL में भाषा और स्थान का सही मिलान होना भी आवश्यक है। ज़्यादातर मामलों में हम इस तरीके का उपयोग करने की सलाह नहीं देते
उदाहरण:https://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8
- टाइप: object | null · Response36Afe1097B20_SerpYahooOrganicLiveRegularResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_SerpYahooOrganicLiveRegularTaskInfo
- 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) के प्रकार शामिल हैं
संभावित आइटम प्रकार:featured_snippet,images,local_pack,hotels_pack,organic,paid,people_also_ask,related_searches,shopping,recipes,top_stories,video,ai_overview;
ध्यान दें कि इस ऐरे में लौटाए गए SERP में मिलने वाले सभी प्रकार के खोज परिणाम शामिल हैं;
हालाँकि, यह endpoint केवलorganic,paidऔरfeatured_snippetप्रकार का डेटा देता है;
लौटाए गए SERP में मिलने वाले सभी आइटम (SERP फ़ीचर और rich snippets सहित) पाने के लिए Yahoo Organiс Advanced SERP endpoint देखें - itemsटाइप: array (object | null)[] | null
SERP में आइटम
- pageटाइप: integer | null
सर्च परिणाम पेज संख्या
उस SERP पेज की संख्या दर्शाता है जिस पर तत्व स्थित है - positionटाइप: string | null
SERP में तत्व का संरेखण
यह निम्न मान ले सकता है:left,right - 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-अक्ष निर्देशांक, जहाँ स्क्रीन का ऊपरी बाएँ कोना मूल बिंदु है
- typeटाइप: string | null
एलिमेंट का प्रकार
- xpathटाइप: string | null
तत्व का XPath
- itemsटाइप: integer | null फ़ॉर्मेट: int64
_count itemsऐरे में लौटाए गए परिणामों की संख्या - keywordटाइप: string | null
POST ऐरे में प्राप्त कीवर्ड
कीवर्ड डिकोड किए गए %## के साथ लौटाया जाता है ('+' वर्ण एक स्पेस में डिकोड होता है) - languageटाइप: string | null
_code POST ऐरे में भाषा कोड
- locationटाइप: integer | null
_code POST ऐरे में स्थान कोड
- pagesटाइप: integer | null फ़ॉर्मेट: int64
_count कुल पेज प्राप्त किए गए
परिणाम में प्राप्त कुल SERP की संख्या - 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
सर्च इंजन का ऑटोकरेक्शन
यदि सर्च इंजन ने किसी सुधारे गए कीवर्ड के लिए परिणाम दिए हैं, तो हम सर्च इंजन द्वारा सुधारा गया कीवर्ड और ऑटोकरेक्शन का प्रकार बताएँगे- 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/yahoo/organic/live/regular \
--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,
"pages_count": null,
"items_count": null,
"items": [
{
"type": null,
"page": null,
"position": null,
"xpath": null,
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}