DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
लाइव YouTube Organic उन्नत
YouTube पर किसी कीवर्ड के रैंक किए गए परिणाम सिंक्रोनस रूप से लौटाता है। keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count और items लौटाता है। advanced डिफ़ॉल्ट विकल्प है; जब केवल रैंक की गई सूची मायने रखे तो regular लें और केवल यह जाँचने के लिए कि पार्सर ने क्या छोड़ा, html लें। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट किया गया response लागत
- संदर्भ request अनुमान: USD 0.002
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array (object | null)[]
- blockटाइप: integer | null
_depth पार्सिंग गहराई वैकल्पिक फ़ील्ड SERP में परिणाम ब्लॉकों की संख्या डिफ़ॉल्ट मान: 20 अधिकतम मान: 200 नोट: आपके खाते से प्रत्येक ऐसे 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
- searchटाइप: string | null
_param सर्च क्वेरी के अतिरिक्त पैरामीटर वैकल्पिक फ़ील्ड उदाहरण: sp=EgIQAg%253D%253D
- tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर वैकल्पिक फ़ील्ड अक्षर सीमा 255 है आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं निर्दिष्ट tag मान response के data ऑब्जेक्ट में मिलेगा
- टाइप: object | null · Response36Afe1097B20_SerpYoutubeOrganicLiveAdvancedResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_SerpYoutubeOrganicLiveAdvancedTaskInfo
- 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) के प्रकार शामिल हैं। संभावित आइटम प्रकार: youtube_channel, youtube_video, youtube_video_paid, youtube_playlist
- itemsटाइप: array (object | null)[] | null
SERP में मिलने वाले खोज परिणामों के तत्व
- blockटाइप: string | null
_name SERP में ब्लॉक का नाम
उदाहरण:"People also watched" - blockटाइप: integer | null
_rank SERP में ब्लॉक रैंक
SERP के सभी ब्लॉकों के बीच स्थिति - channelटाइप: string | null
_id चैनल की ID
- rankटाइप: integer | null
_absolute लक्षित डोमेन के लिए SERP में पूर्ण रैंक
SERP के सभी तत्वों के बीच पूर्ण स्थिति - rankटाइप: integer | null
_group SERP में समूह रैंक
समानtypeमान वाले तत्वों के समूह के भीतर स्थिति
भिन्नtypeमान वाले तत्वों की स्थितियाँrank_groupसे बाहर रखी जाती हैं - typeटाइप: string | null
एलिमेंट का प्रकार
- urlटाइप: string | null
चैनल का URL
- 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 ऐरे में सर्च इंजन डोमेन
- 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
- 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/live/advanced \
--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": [
{
"keyword": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"item_types": [
null
],
"se_results_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"block_rank": null,
"block_name": null,
"channel_id": null,
"url": null
}
]
}
]
}
]
}