दस्तावेज़ देखें
API संदर्भ
YouTube विस्तारित खोज API
वीडियो विवरण, थंबनेल और खोज फिल्टर के साथ, 700 YouTube खोज परिणाम प्रति अनुरोध को पुनर्प्राप्त करें।
अनुरोध बनाएँ
अधिकतम संख्या में खोज परिणाम वापस करने के लिए।
उन्नत पैरामीटर
https://data.flashdata.dev/v1/queries/realtimeपैरामीटर
भेजें source और query शीर्ष स्तर पर। स्रोत विकल्प params. वैकल्पिक क्षेत्रों को छोड़ा जा सकता है।
अनुरोध का मुख्य भाग
sourcestring / ज़रूरी- youtube_search_extended को सेट करें।
querystring / ज़रूरी- क्वेरी खोजें।1 to 2,000 वर्णडिफ़ॉल्ट:
सेट नहीं paramsobject / वैकल्पिक- इस अनुरोध के लिए Settingsडिफ़ॉल्ट:
{} callback_urlstring · nullable / वैकल्पिक- केवल Async और बैच। सार्वजनिक HTTPS पूरा होने URL बंदरगाह 443 पर, 2,048 वर्ण तक। कोई उपयोगकर्ता क्रेडेंशियल या URL खंड नहीं। Omit, उपयोग null या कोई अधिसूचना के लिए एक खाली स्ट्रिंग। एक बैच में, इसे प्रत्येक क्वेरी पर सेट करें, बाहर के पैराम।डिफ़ॉल्ट:
सेट नहीं
परिणाम गणना
params.max_resultsinteger / वैकल्पिक- अनुरोधित परिणाम गिनती। कम परिणाम उपलब्ध हो सकते हैं।1 to 700, पूरी संख्याडिफ़ॉल्ट:
20
फ़िल्टर खोजें
params.filtersobject · nullable / वैकल्पिक- वैकल्पिक अपलोड तिथि, परिणाम प्रकार, अवधि, सॉर्टिंग और फीचर फिल्टर। बिना फिल्टर के null का Omit या उपयोग करें।डिफ़ॉल्ट:
सेट नहीं params.filters.upload_datestring / वैकल्पिक- अपलोड तारीख से फ़िल्टर करें।1 to 2,000 वर्णमान:
today / last_hour / this_week / this_month / this_yearडिफ़ॉल्ट:सेट नहीं params.filters.typestring / वैकल्पिक- परिणाम प्रकार से फ़िल्टर करें।1 to 2,000 वर्णमान:
video / channel / playlist / movieडिफ़ॉल्ट:सेट नहीं params.filters.durationstring / वैकल्पिक- मिनटों में वीडियो अवधि से फ़िल्टर करें।1 to 2,000 वर्णमान:
<4 / 4-20 / >20डिफ़ॉल्ट:सेट नहीं params.filters.sort_bystring / वैकल्पिक- परिणाम का आदेश YouTube के डिफ़ॉल्ट आदेश का उपयोग करने के लिए ओमिट करें।1 to 2,000 वर्णमान:
rating / relevance / view_count / upload_dateडिफ़ॉल्ट:सेट नहीं params.filters.360boolean / वैकल्पिक- true को 360 सुविधा की आवश्यकता के लिए सेट करें।
trueयाfalseडिफ़ॉल्ट:सेट नहीं params.filters.3dboolean / वैकल्पिक- 3 डी फीचर की आवश्यकता के लिए true सेट करें।
trueयाfalseडिफ़ॉल्ट:सेट नहीं params.filters.4kboolean / वैकल्पिक- 4k फीचर की आवश्यकता के लिए true सेट करें।
trueयाfalseडिफ़ॉल्ट:सेट नहीं params.filters.creative_commonsboolean / वैकल्पिक- रचनात्मक कॉमन्स फीचर की आवश्यकता के लिए true सेट करें।
trueयाfalseडिफ़ॉल्ट:सेट नहीं params.filters.hdboolean / वैकल्पिक- HD सुविधा की आवश्यकता के लिए true सेट करें।
trueयाfalseडिफ़ॉल्ट:सेट नहीं params.filters.hdrboolean / वैकल्पिक- सेट true को एचडीआर फीचर की आवश्यकता होती है।
trueयाfalseडिफ़ॉल्ट:सेट नहीं params.filters.liveboolean / वैकल्पिक- true को लाइव फीचर की आवश्यकता के लिए सेट करें।
trueयाfalseडिफ़ॉल्ट:सेट नहीं params.filters.locationboolean / वैकल्पिक- true को स्थान सुविधा की आवश्यकता के लिए सेट करें।
trueयाfalseडिफ़ॉल्ट:सेट नहीं params.filters.purchasedboolean / वैकल्पिक- खरीदी गई सुविधा की आवश्यकता के लिए true सेट करें।
trueयाfalseडिफ़ॉल्ट:सेट नहीं params.filters.subtitlesboolean / वैकल्पिक- सेट true उपशीर्षक सुविधा की आवश्यकता के लिए।
trueयाfalseडिफ़ॉल्ट:सेट नहीं params.filters.vr180boolean / वैकल्पिक- true को vr180 सुविधा की आवश्यकता के लिए सेट करें।
trueयाfalseडिफ़ॉल्ट:सेट नहीं
जवाब
Realtime रिटर्न status: done. पर स्रोत उत्पादन पढ़ें results[0].results; usage.credits चार्ज रिकॉर्ड करता है।
खोज आउटपुट में क्वेरी, totalResults और लौटाए गए आइटम शामिल हैं। totalResults इस प्रतिक्रिया की वस्तुओं की गिनती करता है; यह YouTube पर मिलान वीडियो की कुल संख्या नहीं है।
परिणाम पढ़ें
सफल JSON प्रतिक्रिया को response.json के रूप में सहेजें। इसे read-response.py के रूप में सहेजें और python read-response.py चलाएं। यह केवल Python के मानक पुस्तकालय का उपयोग करता है और कोई नया अनुरोध नहीं करता है।
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
print("[]")
raise SystemExit(0)
result = response["results"][0]
output = [
{"videoId": item.get("videoId"), "title": item.get("title"), "channel": item.get("channel")}
for item in result.get("results", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))20 को max_results डिफॉल्ट्स को 1 को 700 को स्वीकार करते हैं। यह एक बड़ा खोज अनुरोध है, नहीं 700 अलग बैच नौकरियां। बड़े अनुरोधों को लंबे समय तक ले जा सकते हैं; async प्रस्तुतकर्ता के कनेक्शन को खुला रखने से बच जाता है।
फ़िल्टर params.filters में हैं। कम परिणाम उपलब्ध हो सकते हैं, और अमीर आइटम फ़ील्ड null या अनुपस्थित हो सकते हैं। विस्तारित खोज की अपनी खुद की उपयोग दर है।
सभी प्रतिक्रिया क्षेत्र
| फील्ड | विवरण |
|---|---|
sourcestring | अनुरोधित API स्रोत। |
statusstring | जब रियलटाइम अनुरोध सफल होता है तो किया जाता है। |
created_atstring | ISO 8601 प्रारूप में प्रतिक्रिया निर्माण समय। |
usage.creditsnumber | आपकी योजना के आधार पर अनुरोध के लिए शुल्क लिया गया क्रेडिट। |
results[0].querystring | खोज क्वेरी। |
results[0].totalResultsinteger | परिणाम की संख्या वापस आ गई। |
results[0].resultsarray | उनके रिटर्न ऑर्डर में परिणाम खोजें। |
results[0].results[].videoIdstring | YouTube वीडियो ID. |
results[0].results[].titlestring | वीडियो शीर्षक। |
results[0].results[].channelstring | चैनल का नाम |
results[0].results[].channelIdstring · nullable | उपलब्ध होने पर चैनल ID |
results[0].results[].channelUrlstring · nullable | उपलब्ध होने पर चैनल URL |
results[0].results[].durationnumber · nullable | सेकंड में वीडियो अवधि। |
results[0].results[].durationStringstring · nullable | उपलब्ध होने पर प्रारूपित वीडियो अवधि। |
results[0].results[].viewCountnumber · nullable | उपलब्ध होने पर गणना देखें। |
results[0].results[].uploadDatestring · nullable | उपलब्ध होने पर तारीख अपलोड करें। |
results[0].results[].descriptionstring · nullable | विवरण अंश, 500 अक्षरों तक, या null जब अनुपलब्ध हो जाता है। |
results[0].results[].thumbnailsarray | थंबनेल URLs और आयाम। |
ऊपर दिए गए फ़ील्ड डिफ़ॉल्ट JSON प्रतिक्रिया का वर्णन करते हैं। JSON, सादे पाठ और Markdown प्रारूप.
Async एक नौकरी रसीद लौटाता है; बैच प्रति एक रिटर्न देता है क्वेरी. प्रत्येक नौकरी की स्थिति की जांच करें और लौटाए गए लिंक का उपयोग करके अपने परिणाम पुनर्प्राप्त करें।
Async & बैच जीवनचक्र
सबमिशन एक रसीद लौटाता है, परिणाम नहीं देता है। Async एक नौकरी बनाता है; बैच में एक अलग काम देता है queries[] प्रत्येक स्वीकृत क्वेरी के लिए। प्रत्येक नौकरी को स्वतंत्र रूप से ट्रैक और पुनर्प्राप्त करें।
प्रस्तुत करना data.flashdata.dev; नौकरी की स्थिति और परिणाम पढ़ने से api.flashdata.dev उसी X-API-Key के साथ। लिंक्ड API मूलभूत उदाहरण Python और cURL का उपयोग करते हैं।
1. नौकरी बचाओ IDs
इस स्रोत के अनुरोध फ़ील्ड को Async पर स्विच करते समय रखें। Batch के लिए, प्रत्येक अनुरोध को एक JSON ऑब्जेक्ट की क्वेरी सरणी के अंदर रखें। प्रत्येक वापसी कार्य ID बचाओ।
2. स्थिति की जाँच करें
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: देरी और सम्मान के साथ मतदानRetry-Afterजब उपस्थित हो।completed: परिणाम प्राप्त करें।failed: निरीक्षणjob.error.job.status पढ़ें, प्रस्तुतीकरण रसीद की स्थिति नहीं।
नौकरी की स्थिति API संदर्भ3. Fetch परिणाम
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsपूरा होने के बाद, परिणाम को प्रमाणित करें, फिर अपने API कुंजी के बिना 302 संग्रहण URL प्राप्त करें। JSON को 24 घंटे पूरा होने के भीतर सहेजें।
Fetch परिणाम · Python और cURL · जवाब के फ़ॉर्मैट
परिणाम डाउनलोड API
मतदान और मौजूदा परिणाम प्राप्त करने के लिए क्वेरी क्रेडिट का उपभोग नहीं करते हैं। एक मतदान टाइमआउट नौकरी को रद्द नहीं करता है: डुप्लिकेट बिलेबल वर्क जमा करने के बजाय अपने ID को रखें। त्रुटि कोड और पुनर्प्राप्ति व्यवहार.
पूरा होने पर वेबहुक
क्वेरी के अनुसार सदस्यता लें
सेट callback_url एक async अनुरोध के शीर्ष स्तर पर, या प्रत्येक क्वेरी के अंदर एक बैच में, बाहर params. कोई अलग वेबहुक पंजीकरण अनुरोध की आवश्यकता नहीं है। Realtime अनुरोध कॉलबैक नहीं भेजता है।
पोर्ट 443 पर एक सार्वजनिक HTTPS URL का उपयोग करें। FlashData POSTs प्रत्येक नौकरी के लिए एक अधिसूचना तक पहुँचने के लिए completed या failed; इस घटना में लिंक शामिल हैं, न कि परिणाम स्वयं।
स्वीकार करना और सत्यापित करना
वापसी 2xx इस घटना को स्वीकार करने के बाद। Deduplicate by Deduplicate delivery_id, भी भेजा गया X-Delivery-Id. पुनर्निर्देशन का पालन नहीं किया जाता।
विफल प्रसव एक्सोनेंशियल बैकऑफ़ के साथ वापसी, अप करने के लिए 8 कुल प्रयास करता है और अधिक पूरा होने के बाद 24 घंटे. मतदान को गिरने के रूप में रखें।
कॉलबैक को इस्तीफा नहीं दिया जाता है। नौकरी की पुष्टि करें ID, स्रोत और टर्मिनल स्थिति के माध्यम से प्रमाणित स्थिति समापन बिंदु अधिसूचना को संसाधित करने से पहले। वितरण ID, deduplication के लिए है, प्रामाणिकता का प्रमाण नहीं है।
उदाहरण वेबहुक घटना और फ़ील्ड
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "youtube_search_extended",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| फील्ड | विवरण |
|---|---|
delivery_idstring | स्थिर वितरण पहचानकर्ता। इस मूल्य का उपयोग करके Deduplicate नोटिफिकेशन; इसे X-Delivery-Id हेडर में भी भेजा जाता है। |
idstring | नौकरी ID |
sourcestring | अनुरोधित डेटा स्रोत। |
statusstring | पूरा या विफल हो गया। |
linksarray | स्थिति और परिणाम लिंक। अधिसूचनाओं में परिणाम सामग्री या एक API कुंजी शामिल नहीं है। |
links[].relstring | स्वयं या परिणाम। |
links[].hrefstring | पूर्ण प्रबंधन API URL; अपने API कुंजी के साथ प्रमाणित। |
links[].methodstring | GET. |
त्रुटि
यदि एक बड़ी वास्तविक समय में अनुरोध समय बाहर हो जाता है, तो स्वीकृति अनिश्चित हो सकती है। नौकरी के इतिहास की जांच करने से पहले की जाँच करें। बाद में बड़ी खोजों के लिए, async चुनें और लौटे ID को ट्रैक करें।
प्रमाणीकरण, संतुलन, अनुरोध प्रारूप और दर सीमा विफलताओं के लिए, साझा त्रुटि संदर्भ का उपयोग करें। अभी भी एक नौकरी का निर्माण हो सकता है; पुनः प्रयास करने से पहले मौजूदा काम की जांच करें।
चरण-दर-चरण गाइड: एक बड़ा उम्मीदवार खोज योजना