تصفح الوثائق
مرجع API
YouTube ممتدة للبحث API
Retrieve up to 700 YouTube نتائج البحث لكل طلب، مع تفاصيل الفيديو، وأجهزة الإبهام ومرشحات البحث.
إنشاء طلب
أكبر عدد من نتائج البحث للعودة.
معلمات متقدمة
https://data.flashdata.dev/v1/queries/realtimeالبارامترات
أرسل source و query على المستوى الأعلى خيارات المصادر تنتمي إلى params. ويمكن إغفال الحقول الاختيارية.
نص الطلب
sourcestring / مطلوب- جاهزون إلى youtube_search_extended.
querystring / مطلوب- باحث.1 إلى 2,000 الشخصياتالتقصير:
غير محدد paramsobject / اختياري- Settings for this request.التقصير:
{} callback_urlstring · nullable / اختياري- لـ async وbatch فقط. رابط HTTPS عام للإشعار بالاكتمال على المنفذ 443، بطول يصل إلى 2,048 حرفًا، دون بيانات اعتماد مستخدم أو جزء رابط. احذف القيمة أو استخدم null أو سلسلة فارغة لعدم إرسال إشعار. في batch، ضعه في كل استعلام خارج params.التقصير:
غير محدد
عدد النتائج
params.max_resultsinteger / اختياري- عدد النتائج المطلوبة. وقد تكون هناك نتائج أقل.1 إلى 700, أعداد كاملةالتقصير:
20
تصفية البحث
params.filtersobject · nullable / اختياري- تاريخ التحميل الاختياري، ونوع النتائج، والمدة، والفرز، ومرشحات المعالم. أو الاستخدام null بدون مرشحين.التقصير:
غير محدد params.filters.upload_datestring / اختياري- مصور بموعد تحميل1 إلى 2,000 الشخصياتالقيمة:
today / last_hour / this_week / this_month / this_yearالتقصير:غير محدد params.filters.typestring / اختياري- مصور حسب نوع النتيجة1 إلى 2,000 الشخصياتالقيمة:
video / channel / playlist / movieالتقصير:غير محدد params.filters.durationstring / اختياري- مصور بالفيديو خلال دقائق1 إلى 2,000 الشخصياتالقيمة:
<4 / 4-20 / >20التقصير:غير محدد params.filters.sort_bystring / اختياري- طلب النتائج. استعمل YouTubeطلب غير مقصود.1 إلى 2,000 الشخصياتالقيمة:
rating / relevance / view_count / upload_dateالتقصير:غير محدد params.filters.360boolean / اختياري- المجموعة true أن تطلب 360 سمة.
trueأوfalseالتقصير:غير محدد params.filters.3dboolean / اختياري- حددي رقم true لتطلب المميزة 3d.
trueأوfalseالتقصير:غير محدد params.filters.4kboolean / اختياري- المجموعة true لتطلب المميزة الرابعة.
trueأوfalseالتقصير:غير محدد params.filters.creative_commonsboolean / اختياري- (د) أن تضع (زكس كيزوك (true) في حاجة إلى السمة الإبداعية للمشاع.
trueأوfalseالتقصير:غير محدد params.filters.hdboolean / اختياري- المجموعة 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 (لإشتراط سمّية (فور180
trueأوfalseالتقصير:غير محدد
استجابة
Realtime Returns status: done. اقرأ الناتج المصدري في results[0].results; usage.credits سجل التهمة.
ناتج البحث يحتوي على استفسارات totalResults و الأشياء المعادة totalResults يُعدّ هذا الردّ على الأشياء، ليس العدد الإجمالي للفيديو المُطابقة على YouTube.
اقرأ النتيجة
وفّر ردّ شركة JSON الناجح على أنها response.json. احفظ هذا read-response.py و اركضوا بيثون 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))max_results defaults to 20 and accepts 1 to 700. هذا طلب بحث أكبر، ليس 700 وظائف دفعة منفصلة. طلبات أكبر يمكن أن تستغرق وقتاً أطول، (أسينك) يتجنب إبقاء اتصال المُقدم مفتوحاً.
الأفلام تنتمي إلى 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 video 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 | Description excerpt, up to 500 characters, or null when unavailable. |
results[0].results[].thumbnailsarray | Thumbnail URLs and dimensions. |
وتصف المجالات المذكورة أعلاه رد شركة JSON. JSON, plain text and Markdown formats.
Async Returns one job receipt; batch return one per الاستفسار. تحققي من حالة كل وظيفة وإسترجاع نتائجها باستخدام الوصلات العائدة
Async ' batch lifecycle
يعيد الإرسال إيصالًا وليس نتائج. ينشئ Async مهمة واحدة؛ ويعيد batch مهمة مستقلة في queries[] لكل سؤال مقبول تتبع كل وظيفة واسترجاعها بشكل مستقل.
Submit to 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ليس حالة إيصال المعلومات.
المرجعي API3. نتائج الرسم
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsبعد الإكمال، توثّق النتيجة على النحو التالي، ثمّ تُحضر مخزن 302 URL بدون مفتاحك API. وفّر الرقم JSON في غضون ساعات الإنجاز من تاريخ الـ 24.
نتائج المشاهدة: Python و cURL · تنسيقات الاستجابة
Result download API reference
ولا تستهلك السياسات وتحقق النتائج القائمة أي تنازلات للأسئلة. ولا يلغى وقت الاقتراع هذا العمل: فإبقاء مقره ID بدلاً من تقديم عمل مكرر قابل للتعديل. شفرات الرعب وسلوك الاعادة.
إشعارات Webhook عند الاكتمال
Subscribe per query
المجموعة callback_url على أعلى مستوى لطلب الأسينك، أو داخل كل استفسار في دفعة، في الخارج params. ولا يلزم طلب تسجيل منفصل على الشبكة العالمية. ولا تُرسل طلبات شركة Realtime ردوداً.
استخدم عنوان HTTPS عامًا على المنفذ 443. ترسل FlashData إشعار POST لكل مهمة تصل إلى completed أو failed; The event contains links, not the result itself.
الاعتراف والتحقق
العودة 2xx بعد قبول الحدث بشكل مكثف. مُتَوَجَّل delivery_id, كما أُرسلت X-Delivery-Id. لا تتبع إعادة التوجيه.
عمليات التسليم الفاشلة تُعاد مع التراجع المفاجئ، حتى 8 مجموع المحاولات على الأكثر 24 بعد ساعات من الانتهاء. استمر في الاقتراع كتراجع
النداءات غير موقعة. تأكد من معرّف المهمة ومصدرها وحالتها النهائية باستخدام نقطة نهاية الوضع الموثقة قبل تجهيز الإخطار. التسليم ID هو للتحلل، وليس إثبات صحة.
مناسبة وميادين على الشبكة العالمية
{
"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 | معرّف تسليم ثابت. امنع تكرار الإشعارات باستخدام هذه القيمة؛ وتُرسل أيضًا في ترويسة X-Delivery-Id. |
idstring | وظيفة(ب) ID. |
sourcestring | طلب مصدر بيانات. |
statusstring | اكتملت أو فشلت |
linksarray | وصلات الوضع والنتائج. ولا تشمل الإخطارات محتوى النتائج أو مفتاحاً من طراز API. |
links[].relstring | ذاتي أو نتائج. |
links[].hrefstring | عنوان URL كامل لواجهة الإدارة؛ صادِق باستخدام مفتاح API. |
links[].methodstring | GET. |
التعافي من الأخطاء
إذا انتهت مهلة طلب realtime كبير، فقد يكون قبوله غير مؤكد. افحص سجل المهام قبل إعادة إرساله. للبحوث الكبيرة التالية، اختر async وتابع المعرّف العائد.
وللتوثيق، والتوازن، وطريقة الطلب، والإخفاقات في الحد الأقصى للمعدلات، تستخدم مرجع الخطأ المشترك. وقد يكون الوقت المتاح لتقديم الطلبات قد أدى إلى خلق وظيفة؛ والتحقق من العمل القائم قبل إعادة التجريب.
الأخطاء ورموز الحالة · متى يُعيدُ النظر · الحد الأقصى للمعدل
دليل الخطوة خطوة: تخطيط بحث أكبر للمرشحين