DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Local Finder SERP टास्क सेट करें
Google पर स्पष्ट रूप से स्थानीय क्वेरी के लिए Google द्वारा दिखाए जाने वाले विस्तारित स्थानीय परिणाम कतार में डालता है और tasks[0].id में task id लौटाता है। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है। लाइव जुड़वाँ endpoint तुरंत उत्तर देता है और एकल क्वेरी के लिए सरल है; जब बैच एक टूल कॉल से अधिक समय ले तो कतार में डालें।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट किया गया response लागत
- संदर्भ request अनुमान: USD 0.02
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array (object | null)[]
- depthटाइप: integer | null
पार्सिंग गहराई
वैकल्पिक फ़ील्ड
SERP में परिणामों की संख्या
डिफ़ॉल्ट मान:
10अधिकतम मान:
350
ऐसे प्रत्येक SERP के लिए आपके खाते से बिल लिया जाएगा जिसमें अधिकतम 10 परिणाम हों;
10 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन तदनुसार 10 से अधिक परिणाम लौटाता है;यदि निर्दिष्ट गहराई response में परिणामों की संख्या से अधिक है, तो अंतर स्वतः आपके खाते की शेष राशि में वापस कर दिया जाएगा
लागत Pricing पेज पर गणना की जा सकती है। - 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निर्दिष्ट करने की आवश्यकता नहीं हैआप
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,18z - 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टाइप: number | null फ़ॉर्मेट: double
_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 - pingbackटाइप: string | null
_url पूर्ण टास्क का नोटिफिकेशन URL
वैकल्पिक फ़ील्ड
जब कोई टास्क पूरा होता है, तो हम आपके द्वारा निर्दिष्ट URL पर भेजे गए GET request के माध्यम से आपको सूचित करेंगे
आप ‘$id’ स्ट्रिंग को
$idवेरिएबल के रूप में और ‘$tag’ को urlencoded$tagवेरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट कर देंगे।उदाहरण:
http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagनोट:
pingback_urlमें विशेष अक्षर urlencoded किए जाएँगे;अर्थात,
#अक्षर%23में एन्कोड किया जाएगा
हमारे Help Center पर अधिक जानें
- postbackटाइप: string
_data postback_url डेटाटाइप
postback_urlनिर्दिष्ट करने पर आवश्यक फ़ील्डटास्क सेट करने के लिए उपयोग किए गए फ़ंक्शन से मेल खाता है
संभावित मान:
advanced,html - postbackटाइप: string | null
_url टास्क परिणाम भेजने के लिए URL
वैकल्पिक फ़ील्ड
टास्क पूरा होने के बाद, हम
gzipप्रारूप में संपीड़ित परिणामों के साथ एक POST request आपके द्वारा निर्दिष्टpostback_urlपर भेजेंगेआप ‘$id’ स्ट्रिंग को
$idवेरिएबल के रूप में और ‘$tag’ को urlencoded$tagवेरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट कर देंगे।उदाहरण:
http://your-server.com/postbackscript?id=$idhttp://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ऑब्जेक्ट में पाएँगे - 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_SerpGoogleLocalFinderTaskPostResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_SerpGoogleLocalFinderTaskPostTaskInfo
- 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टाइप: object | null
परिणामों का ऐरे
इस मामले में, मान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/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "local nail services",
"min_rating": 4.5,
"time_filter": "monday"
}
]'
{
"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
}
]
}