DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
लाइव Google Local Finder SERP HTML
सिंक्रोनस रूप से Google पर स्पष्ट रूप से स्थानीय क्वेरी के लिए Google द्वारा दिखाए जाने वाले विस्तारित स्थानीय परिणाम लौटाता है। पार्स किए गए परिणामों के बजाय कच्चा पेज सोर्स। 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
पार्सिंग गहराई
वैकल्पिक फ़ील्ड
SERP में परिणामों की संख्या
डिफ़ॉल्ट मान:
10अधिकतम मान:
100
ऐसे प्रत्येक SERP के लिए आपके खाते से बिल लिया जाएगा जिसमें अधिकतम 10 परिणाम हों;10 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन 10 से अधिक परिणाम लौटाता है;
यदि निर्दिष्ट गहराई response में परिणामों की संख्या से अधिक है, तो अंतर स्वतः आपके खाते की शेष राशि में वापस कर दिया जाएगा
लागत Pricing पेज पर गणना की जा सकती है।
- deviceटाइप: string | null
डिवाइस प्रकार
वैकल्पिक फ़ील्ड
किसी विशेष डिवाइस प्रकार के लिए परिणाम लौटाएँ
यह निम्न मान ले सकता है:
desktop,mobileडिफ़ॉल्ट मान:
desktop - keywordटाइप: string
कीवर्ड
आवश्यक फ़ील्ड
आप
keywordफ़ील्ड में अधिकतम 700 अक्षर निर्दिष्ट कर सकते हैंसभी %## डिकोड किए जाएँगे (साथ ही ‘+’ अक्षर एक स्पेस अक्षर में डिकोड होगा)
यदि आप अपने
keywordके लिए “%” अक्षर उपयोग करना चाहते हैं, तो उसे “%25” के रूप में निर्दिष्ट करें;यदि आप अपने
keywordके लिए “+” अक्षर उपयोग करना चाहते हैं, तो उसे “%2B” के रूप में निर्दिष्ट करें - 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निर्दिष्ट करने की आवश्यकता नहीं हैआप
location_codeके साथ सर्च इंजनों के उपलब्ध स्थानों की सूचीhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsपर अलग request भेजकर प्राप्त कर सकते हैंउदाहरण:
2840 - 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,20z - locationटाइप: string
_name सर्च इंजन स्थान का पूरा नाम
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 - minटाइप: string | null
_rating न्यूनतम रेटिंग के आधार पर परिणाम फ़िल्टर करें
वैकल्पिक फ़ील्ड
desktopके लिए संभावित मान:3.5,4,4.5;mobileके लिए संभावित मान:2,2.5,3,3.5,4,4.5 - osटाइप: string | null
डिवाइस ऑपरेटिंग सिस्टम
वैकल्पिक फ़ील्ड
यदि आप
deviceफ़ील्ड मेंdesktopनिर्दिष्ट करते हैं, तो निम्न में से चुनें:windows,macosडिफ़ॉल्ट मान:
windowsयदि आप
deviceफ़ील्ड मेंmobileनिर्दिष्ट करते हैं, तो निम्न में से चुनें:android,iosडिफ़ॉल्ट मान:
android - tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
वैकल्पिक फ़ील्ड
अक्षर सीमा 255 है
आप इस पैरामीटर का उपयोग टास्क की पहचान करने और उसे परिणाम से मिलाने के लिए कर सकते हैं
आप निर्दिष्ट
tagमान response केdataऑब्जेक्ट में पाएँगे - timeटाइप: string | null
_filter खुलने के समय के आधार पर परिणाम फ़िल्टर करें
वैकल्पिक फ़ील्ड
इस फ़ील्ड का उपयोग करके आप परिणामों में स्थानों को उस समय के आधार पर फ़िल्टर कर सकते हैं जब वह स्थान आगंतुकों के लिए खुला होता है
ध्यान दें कि Google ऐसे परिणाम भी दे सकता है जो इस फ़िल्टर से मेल नहीं खाते
संभावित मान:
"open_now","24_hours","$day_value","$day_value;$time_value";$day_valueके स्थान पर इनमें से कोई एक मान उपयोग करें:"monday","tuesday","wednesday","thursday","friday","saturday","sunday";$time_valueके स्थान पर इनमें से कोई एक मान उपयोग करें:"00","01","02","03","04","05","06","07","08","09","10","11","12","13","14","15","16","17","18","19","20","21","22","23"उदाहरण:
"tuesday;18"
- टाइप: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveHtmlResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveHtmlTaskInfo
- 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
परिणामों का ऐरे
- datetimeटाइप: string | null
वह तारीख और समय जब परिणाम प्राप्त हुआ
UTC प्रारूप में: “yyyy-mm-dd hh-mm-ss +00:00”
उदाहरण:2019-11-15 12:57:46 +00:00 - itemsटाइप: array (object | null)[] | null
SERP में मिले सर्च परिणामों के तत्व
- dateटाइप: string | null
वह तारीख और समय जब HTML पेज स्कैन किया गया
UTC प्रारूप में: “yyyy-mm-dd hh-mm-ss +00:00”
उदाहरण:2019-11-15 12:57:46 +00:00 - htmlटाइप: string | null
HTML पेज
- pageटाइप: integer | null
लौटाए गए HTML पेज की क्रम संख्या
- itemsटाइप: integer | null फ़ॉर्मेट: int64
_count itemsऐरे में लौटाए गए परिणामों की संख्या - keywordटाइप: string | null
POST ऐरे में प्राप्त कीवर्ड
कीवर्ड डिकोड किए गए %## के साथ लौटाया जाता है ('+' वर्ण एक स्पेस में डिकोड होता है) - languageटाइप: string | null
_code POST ऐरे में भाषा कोड
- locationटाइप: integer | null
_code POST ऐरे में स्थान कोड
- seटाइप: string | null
_domain POST ऐरे में सर्च इंजन डोमेन
- 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/local_finder/live/html \
--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,
"datetime": null,
"items_count": null,
"items": [
{
"page": null,
"date": null,
"html": null
}
]
}
]
}
]
}