DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
YouTube Organic टास्क सेट करना
YouTube पर किसी कीवर्ड के रैंक किए गए परिणाम कतार में डालता है, और tasks[0].id में task id लौटाता है। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है। लाइव जुड़वाँ तुरंत उत्तर देता है और एक ही क्वेरी के लिए सरल है; जब पूरा बैच एक टूल कॉल से अधिक समय ले, तब कतार में डालें।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट किया गया response लागत
- संदर्भ request अनुमान: USD 0.02
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array (object | null)[]
- blockटाइप: integer | null
_depth पार्सिंग गहराई वैकल्पिक फ़ील्ड SERP में परिणाम ब्लॉकों की संख्या डिफ़ॉल्ट मान: 20 अधिकतम मान: 700 नोट: आपके खाते से प्रत्येक ऐसे SERP के लिए बिल लिया जाएगा जिसमें अधिकतम 20 परिणाम ब्लॉक हों; इसलिए, 20 से अधिक ब्लॉक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन 20 से अधिक परिणाम लौटाता है; यदि निर्दिष्ट ब्लॉक गहराई response में परिणामों की संख्या से अधिक है, तो अंतर स्वतः आपके खाते की शेष राशि में वापस कर दिया जाएगा
- deviceटाइप: string | null
डिवाइस प्रकार वैकल्पिक फ़ील्ड किसी विशिष्ट डिवाइस प्रकार के लिए परिणाम लौटाएँ उपलब्ध मान: desktop, mobile
- keywordटाइप: string
कीवर्ड आवश्यक फ़ील्ड आप keyword फ़ील्ड में अधिकतम 700 अक्षर निर्दिष्ट कर सकते हैं सभी %## डिकोड किए जाएँगे (‘+’ अक्षर एक स्पेस अक्षर में डिकोड होगा) यदि आपको अपने keyword के लिए “%” अक्षर का उपयोग करना है, तो उसे “%25” के रूप में निर्दिष्ट करें; यदि आपको अपने keyword के लिए “+” अक्षर का उपयोग करना है, तो उसे “%2B” के रूप में निर्दिष्ट करें; DataForSEO APIs में keyword और keywords फ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में और जानें
- languageटाइप: string | null
_code सर्च इंजन भाषा कोड language_name निर्दिष्ट न करने पर आवश्यक फ़ील्ड यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_name निर्दिष्ट करने की आवश्यकता नहीं है आप language_code के साथ सर्च इंजन की उपलब्ध भाषाओं की सूची https://api.dataforseo.com/v3/serp/youtube/languages पर अलग request भेजकर प्राप्त कर सकते हैं उदाहरण: en
- languageटाइप: string | null
_name सर्च इंजन भाषा का पूरा नाम language_code निर्दिष्ट न करने पर आवश्यक फ़ील्ड यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_code निर्दिष्ट करने की आवश्यकता नहीं है आप language_name के साथ सर्च इंजन की उपलब्ध भाषाओं की सूची https://api.dataforseo.com/v3/serp/youtube/languages पर अलग request भेजकर प्राप्त कर सकते हैं उदाहरण: English
- locationटाइप: integer | null
_code सर्च इंजन स्थान कोड location_name निर्दिष्ट न करने पर आवश्यक फ़ील्ड यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name निर्दिष्ट करने की आवश्यकता नहीं है आप location_code के साथ सर्च इंजनों के उपलब्ध स्थानों की सूची https://api.dataforseo.com/v3/serp/youtube/locations पर अलग request भेजकर प्राप्त कर सकते हैं उदाहरण: 2840
- locationटाइप: string | null
_name सर्च इंजन स्थान का पूरा नाम location_code निर्दिष्ट न करने पर आवश्यक फ़ील्ड यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_code निर्दिष्ट करने की आवश्यकता नहीं है आप location_name के साथ सर्च इंजन के उपलब्ध स्थानों की सूची https://api.dataforseo.com/v3/serp/youtube/locations पर अलग request भेजकर प्राप्त कर सकते हैं उदाहरण: United States
- 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=$id http://your-server.com/pingscript?id=$id&tag=$tag नोट: pingback_url में विशेष अक्षर urlencode किए जाएँगे; जैसे, # अक्षर %23 में एन्कोड हो जाएगा हमारे Help Center पर और जानें
- postbackटाइप: string | null
_data postback_url डेटाटाइप postback_url निर्दिष्ट करने पर आवश्यक फ़ील्ड आपके सर्वर पर भेजे जाने वाले डेटाटाइप से मेल खाता है संभावित मान: advanced
- postbackटाइप: string | null
_url टास्क परिणाम भेजने के लिए URL वैकल्पिक फ़ील्ड टास्क पूरा होने के बाद, हम gzip प्रारूप में संपीड़ित परिणामों के साथ एक POST request आपके द्वारा निर्दिष्ट postback_url पर भेजेंगे आप ‘$id’ स्ट्रिंग को $id वेरिएबल के रूप में और ‘$tag’ को urlencoded $tag वेरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट कर देंगे। उदाहरण: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag नोट: postback_url में विशेष अक्षर urlencode किए जाएँगे; जैसे, # अक्षर %23 में एन्कोड हो जाएगा हमारे Help Center पर और जानें
- priorityटाइप: integer | null
टास्क प्राथमिकता वैकल्पिक फ़ील्ड निम्नलिखित मान ले सकता है: 1 – सामान्य निष्पादन प्राथमिकता (डिफ़ॉल्ट रूप से सेट) 2 – उच्च निष्पादन प्राथमिकता उच्च निष्पादन प्राथमिकता वाले टास्क के लिए आपसे अतिरिक्त शुल्क लिया जाएगा। लागत Pricing पेज पर गणना की जा सकती है।
- searchटाइप: string | null
_param सर्च क्वेरी के अतिरिक्त पैरामीटर वैकल्पिक फ़ील्ड उदाहरण: sp=EgIQAg%253D%253D
- tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर वैकल्पिक फ़ील्ड अक्षर सीमा 255 है आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं निर्दिष्ट tag मान response के data ऑब्जेक्ट में मिलेगा
- टाइप: object | null · Response36Afe1097B20_SerpYoutubeOrganicTaskPostResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_SerpYoutubeOrganicTaskPostTaskInfo
- 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/youtube/organic/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "audi"
}
]'
{
"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
}
]
}