DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Baidu Organic SERP टास्क सेट करना
Baidu पर किसी कीवर्ड के रैंक किए गए परिणाम कतार में डालता है, और 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 बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array (object | null)[]
- depthटाइप: integer | null
पार्सिंग गहराई
वैकल्पिक फ़ील्ड
SERP में परिणामों की संख्या
डिफ़ॉल्ट मान:10
अधिकतम मान:700
आपके खाते से प्रत्येक SERP के लिए शुल्क लिया जाएगा जिसमें अधिकतम 10 परिणाम हों;
10 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन 10 से अधिक परिणाम लौटाता है;
लागत की गणना Pricing पेज पर की जा सकती है - deviceटाइप: string | null
डिवाइस प्रकार
वैकल्पिक फ़ील्ड
किसी विशिष्ट डिवाइस प्रकार के लिए परिणाम लौटाएँ
मान ले सकता है:desktop,mobile,tablet
डिफ़ॉल्ट मान:desktop - getटाइप: boolean | null
_website _url प्रत्येक रैंक किए गए परिणाम के लिए सीधा URL शामिल करें
वैकल्पिक फ़ील्ड
यदिtrueपर सेट है, तो लौटाए गए परिणामों में रैंक की गई वेबसाइटों के सीधे URL होंगे
डिफ़ॉल्ट रूप से, Baidu परिणामों में URL सर्च इंजन द्वारा एन्कोड किए जाते हैं
उदाहरण:http://www.baidu.com/link?url=KQt6LSwU5OHnPtB8210R8flBP40grY6lTPxH_0UO7S2kgiZMTmw3ztV0hCo5c1kLडिफ़ॉल्ट मान:false
नोट: यदिtrueपर सेट है, तो प्रति टास्क शुल्क 10 गुना हो जाएगा क्योंकि हमारा सिस्टम प्रत्येक रैंक की गई वेबसाइट के सीधे URL को लौटाने के लिए अलग request चलाता है - keywordटाइप: string
कीवर्ड
आवश्यक फ़ील्ड
आपkeywordफ़ील्ड में अधिकतम 700 अक्षर निर्दिष्ट कर सकते हैं
सभी %## डिकोड किए जाएँगे (‘+’ अक्षर एक स्पेस अक्षर में डिकोड होगा)
यदि आपको अपनेkeywordमें “%” अक्षर उपयोग करना है, तो उसे “%25” के रूप में निर्दिष्ट करें;
यदि आपको अपनेkeywordमें “+” अक्षर उपयोग करना है, तो उसे “%2B” के रूप में निर्दिष्ट करेंDataForSEO API में
keywordऔरkeywordsफ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में जानें - languageटाइप: string
_code सर्च इंजन भाषा कोड
आवश्यक फ़ील्ड यदि आप निर्दिष्ट नहीं करतेlanguage_name
आपhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesपर अलग request भेजकरlanguage_codeके साथ सर्च इंजन की उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैंध्यान दें कि Baidu सर्च इंजन में केवलzh_CNभाषा कोड वालीChinese (Simplified)भाषा समर्थित है। हालाँकि, Baidu अन्य भाषाओं की क्वेरी के लिए भी परिणाम लौटा सकता है, इसलिएkeywordको चीनी में निर्दिष्ट करना अनिवार्य नहीं हैउदाहरण:
zh_CN - languageटाइप: string
_name सर्च इंजन भाषा का पूरा नाम
आवश्यक फ़ील्ड यदि आप निर्दिष्ट नहीं करतेlanguage_code
आपhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesपर अलग request भेजकरlanguage_nameके साथ सर्च इंजन की उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैंध्यान दें कि Baidu सर्च इंजन में केवलChinese (Simplified)भाषा समर्थित है। हालाँकि, Baidu अन्य भाषाओं की क्वेरी के लिए भी परिणाम लौटा सकता है, इसलिएkeywordको चीनी में निर्दिष्ट करना अनिवार्य नहीं हैउदाहरण:
Chinese (Simplified) - locationटाइप: integer
_code सर्च इंजन स्थान कोड
आवश्यक फ़ील्ड यदि आप निर्दिष्ट नहीं करतेlocation_nameयाlocation_coordinate
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlocation_nameयाlocation_coordinateनिर्दिष्ट करने की आवश्यकता नहीं है
आपhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsपर अलग request भेजकरlocation_codeके साथ सर्च इंजन के उपलब्ध स्थानों की सूची प्राप्त कर सकते हैं
उदाहरण:2156 - 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के साथ सर्च इंजन के उपलब्ध स्थानों की सूची प्राप्त कर सकते हैं
उदाहरण:New York,New York,United States - maxटाइप: integer | null
_crawl _pages - osटाइप: string | null
डिवाइस ऑपरेटिंग सिस्टम
वैकल्पिक फ़ील्ड
यदिdeviceफ़ील्ड मेंdesktopनिर्दिष्ट है, तो निम्न में से चुनें:windows,macos
डिफ़ॉल्ट मान:windows
यदिdeviceफ़ील्ड मेंmobileनिर्दिष्ट है, तो निम्न में से चुनें:android,ios
डिफ़ॉल्ट मान:android
यदिdeviceफ़ील्ड मेंtabletनिर्दिष्ट है, तो निम्न में से चुनें:android,ios
डिफ़ॉल्ट मान:android - pingbackटाइप: string | null
_url पूर्ण टास्क का नोटिफ़िकेशन URL
वैकल्पिक फ़ील्ड
टास्क पूरा होने पर हम आपके निर्दिष्ट URL पर GET request भेजकर सूचित करेंगे
आप ‘$id’ स्ट्रिंग को$idवैरिएबल के रूप में और ‘$tag’ को URL-एन्कोडेड$tagवैरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट करेंगे।
उदाहरण:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
नोट:pingback_urlमें विशेष वर्ण URL-एन्कोड होंगे;
अर्थात्,#वर्ण%23में एन्कोड होगा - postbackटाइप: string
_data postback_url डेटाटाइप
आवश्यक फ़ील्ड यदिpostback_urlनिर्दिष्ट है
आपके सर्वर पर भेजे जाने वाले डेटा के प्रकार से मेल खाता है
संभावित मान:regular,html - postbackटाइप: string | null
_url टास्क परिणाम भेजने का URL
वैकल्पिक फ़ील्ड
टास्क पूरा होने पर हम उसके परिणामों कोgzipप्रारूप में संपीड़ित करके आपके निर्दिष्टpostback_urlपर POST request भेजेंगे
आप ‘$id’ स्ट्रिंग को$idवैरिएबल के रूप में और ‘$tag’ को URL-एन्कोडेड$tagवैरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट करेंगे।
उदाहरण:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
नोट:postback_urlमें विशेष वर्ण URL-एन्कोड होंगे;
अर्थात्,#वर्ण%23में एन्कोड होगा - priorityटाइप: integer | null
- 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ऑब्जेक्ट में मिलेगा
- टाइप: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostTaskInfo
- 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/baidu/organic/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_code": 2156,
"keyword": "best iphone ever",
"tag": "some_string_123",
"priority": 2
}
]'
{
"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
}
]
}