वीडियो · YouTube
YouTube Video Data API
YouTube Video Data API से आपको लाइव YouTube डेटा ठीक उसी पल मिलता है जब आप पूछते हैं, साफ़ स्ट्रक्चर्ड रूप में – आपके ऐप, स्प्रेडशीट या AI असिस्टेंट के लिए तैयार। न स्क्रैपिंग, न रखरखाव।
हर महीने 100 फ़्री रिक्वेस्ट · क्रेडिट कार्ड की ज़रूरत नहीं · सभी प्लेटफ़ॉर्म के लिए एक API key
मुख्य तथ्य
अपडेट:
हर YouTube watch पेज पर सार्वजनिक मेटाडेटा का एक समृद्ध ब्लॉक होता है: टाइटल और विवरण, उसके पीछे का चैनल, व्यू, लाइक और कमेंट की कुल संख्या, पब्लिश तारीख़, अवधि, कैटेगरी, कीवर्ड टैग, थंबनेल और उपलब्ध कैप्शन ट्रैक। everydata.io का YouTube Video Data API किसी भी वीडियो ID या URL के लिए यह ब्लॉक एक JSON ऑब्जेक्ट के रूप में लौटाता है। कोई OAuth consent स्क्रीन नहीं, कोई Google Cloud प्रोजेक्ट नहीं और बाँटकर इस्तेमाल करने वाला कोई दैनिक यूनिट quota नहीं – बस आपकी everydata.io key के साथ एक HTTPS GET, जिसका जवाब लाइव पेज से आता है।
- प्लेटफ़ॉर्म
- YouTube
- मुख्य endpoint
- /youtube-video-details
- हर कॉल पर quota
- 1 रिक्वेस्ट
- फ़्री प्लान
- 100 रिक्वेस्ट / महीनाउसके बाद €30 / महीना से
YouTube डेटा, इस्तेमाल के लिए तैयार
GET /ytb/youtube-video-details, id के रूप में सादा वीडियो ID (kJQP7kiw5Fk), youtu.be छोटा लिंक या पूरा watch URL स्वीकार करता है, ताकि आपके यूज़र जो भी पेस्ट करें आप उसे दे सकें। रिस्पॉन्स में अपलोडर के लिए videoId, title, description, channelId, channelName, channelUrl और subscriberCountText होते हैं, फिर पूर्णांक के रूप में engagement नंबर: viewCount, likeCount और commentCount, और गोल की गई display वैल्यू के लिए likeCountText। publishedAt और uploadDate offset के साथ ISO टाइमस्टैम्प हैं, duration सेकंड में है और durationText m:ss में, और category, keywords व tags अपलोडर का चुना वर्गीकरण रखते हैं।
boolean फ़्लैग वीडियो की स्थिति बताते हैं: isLive, isLiveNow, isFamilySafe, isUnlisted, isPrivate, isShortsEligible और allowRatings। availableCountries बताता है कि प्लेबैक कहाँ अनुमत है, embedUrl iframe के लिए तैयार है, और captions[] में हर सबटाइटल ट्रैक languageCode, name और isTranslatable के साथ होता है।
- वीडियो ID, youtu.be लिंक या पूरा watch URL उसी id पैरामीटर में स्वीकार
- viewCount, likeCount, commentCount सादे पूर्णांक के रूप में, साथ में पढ़ने लायक *Text वेरिएंट
- publishedAt, uploadDate, duration, durationText, category, keywords[] और tags[]
- चैनल का संदर्भ साथ में: channelId, channelName, channelUrl, channelThumbnails, subscriberCountText
- स्टेटस फ़्लैग: isLive, isLiveNow, isFamilySafe, isUnlisted, isPrivate, isShortsEligible, allowRatings
- कई साइज़ में thumbnails[], embedUrl, availableCountries[] और भाषा व अनुवाद-योग्यता के साथ captions[]
- कीवर्ड सर्च, related वीडियो और trending के लिए सहायक endpoint – सभी cursor-paged, बिना Google API key
टीमें इससे क्या बनाती हैं
इन्फ़्लुएंसर और कैंपेन रिपोर्टिंग
स्पॉन्सर्ड वीडियो के लिए शेड्यूल पर viewCount, likeCount और commentCount फ़ेच करें और पब्लिश तारीख़ से आगे का कर्व चार्ट करें – क्लाइंट्स में बाँटने के लिए कोई यूनिट बजट नहीं।
कंटेंट मॉनिटरिंग और ब्रांड सेफ़्टी
यूज़र का भेजा हर URL resolve करें, title, channelName, category और isFamilySafe सेव करें, और जो वीडियो बाद में प्राइवेट या unlisted हो जाएँ उन्हें 404 रिस्पॉन्स से चिह्नित करें।
सर्च और ट्रेंड ट्रैकिंग
एक ही कीवर्ड को अलग-अलग countryCode वैल्यू के साथ रोज़ youtube-search-videos से चलाएँ और मापें कि हर बाज़ार में कौन-से चैनल और फ़ॉर्मैट रिज़ल्ट पर हावी हैं।
लिंक प्रीव्यू और एम्बेड
पेस्ट किए गए YouTube लिंक को थंबनेल, टाइटल, चैनल और अवधि वाले कार्ड में बदलें, और embedUrl से एम्बेड करें – Google credential के बिना क्लासिक oEmbed उपयोग।
उदाहरण रिक्वेस्ट और रिस्पॉन्स
एक कॉल पूरा watch-page ब्लॉक लौटाती है; उदाहरण Despacito का है, इसलिए काउंटर असली और बड़े हैं। डिस्कवरी के लिए GET /ytb/youtube-search-videos?query=lofi+hip+hop, videoId, title, channelName, viewCount, duration और isLive के साथ items[] और एक cursor लौटाता है; /ytb/youtube-video-related-contents किसी वीडियो की साइडबार सिफ़ारिशें दिखाता है, और /ytb/youtube-trending-videos trending टैब लौटाता है।
GET /ytb/youtube-video-details
curl "https://api.everydata.io/ytb/youtube-video-details?id=kJQP7kiw5Fk&languageCode=en&countryCode=US" \
-H "x-api-key: YOUR_API_KEY"रिस्पॉन्स (संक्षिप्त)
{
"responseStatus": "PAGE_FOUND",
"responseMessage": "Page successfully found!",
"videoId": "kJQP7kiw5Fk",
"title": "Luis Fonsi - Despacito ft. Daddy Yankee",
"channelId": "UCLp8RBhQHu9wSsq62j_Md6A",
"channelName": "LuisFonsiVEVO",
"subscriberCountText": "32.5M subscribers",
"viewCount": 9125159593,
"likeCount": 56673581,
"likeCountText": "56M",
"commentCount": 4300000,
"publishedAt": "2017-01-12T21:00:02-08:00",
"duration": 282,
"durationText": "4:42",
"category": "Music",
"keywords": [
"Luis",
"Fonsi"
],
"tags": [
"Calypso",
"Despacito"
],
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/kJQP7kiw5Fk/hqdefault.jpg",
"width": 168,
"height": 94
}
],
"isLive": false,
"isFamilySafe": true,
"embedUrl": "https://www.youtube.com/embed/kJQP7kiw5Fk"
}watch पेज रेंडर होने पर responseStatus PAGE_FOUND होता है। प्राइवेट, डिलीट किया गया या region-blocked वीडियो आधे-भरे ऑब्जेक्ट के बजाय vnd.error बॉडी के साथ 404 देता है, इसलिए पार्स करने से पहले HTTP स्टेटस जाँचें। viewCount रिक्वेस्ट के समय पेज का सटीक आँकड़ा है; YouTube ख़ुद इसे थोड़ी देरी से अपडेट करता है, इसलिए धीमे चलने वाले वीडियो पर कुछ मिनट के अंतर वाली दो कॉल एक ही संख्या लौटा सकती हैं।
search और related-content रिस्पॉन्स एक opaque cursor स्ट्रिंग से पेज किए जाते हैं। आगे बढ़ने के लिए एक रिस्पॉन्स का cursor वैल्यू अगली कॉल के cursor पैरामीटर में भेजें; पेज एक के लिए इसे छोड़ दें। हर पेज एक रिक्वेस्ट है। search पर estimatedResults YouTube का अपना मोटा कुल आँकड़ा है, इस बात की गारंटी नहीं कि आप कितने पेज देख पाएँगे।
languageCode और countryCode (डिफ़ॉल्ट en, US) प्रभावित करते हैं कि YouTube क्या रेंडर करता है: जहाँ अपलोडर ने अनुवाद दिए हों वहाँ स्थानीय टाइटल, और देश की trending लिस्ट। हर रिक्वेस्ट रियलटाइम है; YouTube endpoint पर कोई cacheTtl नहीं है, क्योंकि काउंटर लगातार बदलते रहते हैं।
संबंधित endpoints
वीडियो विवरण. वीडियो id या URL के लिए मेटाडेटा।
वीडियो सर्च करें. cursor पेजिंग के साथ कीवर्ड सर्च।
Related वीडियो. किसी वीडियो का related कंटेंट।
Trending. Trending वीडियो।
प्रति रिक्वेस्ट भुगतान, सभी प्लेटफ़ॉर्म शामिल
एक video detail कॉल, एक सर्च पेज या एक related-content पेज एक रिक्वेस्ट के बराबर है। चूँकि कोई अलग Google quota नहीं है, एकमात्र सीमा आपका everydata.io प्लान है: फ़्री टियर की हर महीने 100 रिक्वेस्ट इंटीग्रेशन टेस्ट के लिए काफ़ी हैं; Starter (5,000 रिक्वेस्ट, €30) रोज़ लगभग 160 वीडियो ट्रैक करता है; Production (50,000, €80) सैकड़ों चैनलों पर एजेंसी-स्तर की रिपोर्टिंग संभालता है। upstream 5xx एरर कभी नहीं कटतीं।
- Free
- 100 रिक्वेस्ट / महीना
- Starter
- 5,000 रिक्वेस्ट · €30
- Production
- 50,000 रिक्वेस्ट · €80
- Business
- 3,00,000 रिक्वेस्ट · €300
YouTube Video Data API: अक्सर पूछे जाने वाले सवाल
क्या मुझे Google API key या OAuth टोकन चाहिए?
नहीं। रिक्वेस्ट सिर्फ़ आपकी everydata.io key से authenticate होती हैं। डेटा YouTube के सार्वजनिक watch, search और channel पेजों से आता है, इसलिए इसमें कोई Google Cloud प्रोजेक्ट, consent फ़्लो या 10,000 यूनिट का दैनिक quota शामिल नहीं है।
कौन-से id फ़ॉर्मैट स्वीकार किए जाते हैं?
11 अक्षरों वाला वीडियो ID, youtu.be छोटा लिंक, पूरा www.youtube.com/watch?v= URL और Shorts URL। एक ही id पैरामीटर इन सबको संभालता है; रिस्पॉन्स में हमेशा नॉर्मलाइज़ किया गया videoId होता है।
क्या मुझे dislike संख्या या watch-time आँकड़े मिल सकते हैं?
नहीं। YouTube ने 2021 में सार्वजनिक dislike संख्या हटा दी और watch time सिर्फ़ YouTube Studio में चैनल मालिक को दिखता है। API सार्वजनिक काउंटर लौटाता है: viewCount, likeCount और commentCount।
मैं सर्च रिज़ल्ट में पेज-दर-पेज कैसे आगे बढ़ूँ?
हर सर्च रिस्पॉन्स में एक cursor स्ट्रिंग होती है। अगला पेज फ़ेच करने के लिए उसे cursor पैरामीटर के रूप में वापस भेजें और तब तक चलते रहें जब तक कोई cursor न लौटे। पेजों में आमतौर पर लगभग 20 आइटम होते हैं, isLive से चिह्नित लाइव स्ट्रीम सहित।
क्या age-restricted या प्राइवेट वीडियो सपोर्टेड हैं?
प्राइवेट वीडियो 404 लौटाते हैं, क्योंकि उनका पेज सार्वजनिक नहीं है। age-restricted वीडियो वहाँ मेटाडेटा लौटाते हैं जहाँ YouTube उसे बिना साइन-इन के दिखाता है; जहाँ पेज को लॉगिन चाहिए, वहाँ कॉल भी 404 लौटाती है।
संबंधित उपयोग के उदाहरण
अपना पहला वीडियो लुकअप करें
फ़्री अकाउंट बनाएँ और GET /ytb/youtube-video-details?id=kJQP7kiw5Fk कॉल करें – एक JSON रिस्पॉन्स में पूरा मेटाडेटा, हर महीने 100 रिक्वेस्ट हमारी ओर से।