Semak dokumentasi
Rujukan API
YouTube Lanjutan Pencarian API
Retrieve up to 700 YouTube hasil pencarian per permintaan, dengan rincian video, thumbnail dan filter pencarian.
Bina permintaan
Jumlah maksimum hasil pencarian yang dikembalikan.
Parameter lanjutan
https://data.flashdata.dev/v1/queries/realtimeParameter
Kirim source Dan query Di tingkat atas. Pilihan sumber termasuk dalam params. Bidang opsional dapat diabaikan.
Badan permintaan
sourcestring / Wajib- Ditetapkan untuk youtube_search_extended.
querystring / Wajib- Pertanyaan pencarian.1 Ke 2,000 aksaraDefault:
Tidak Diset paramsobject / Pilihan- Settings untuk permintaan ini.Default:
{} callback_urlstring · nullable / Pilihan- Async dan hanya kelumpuhan. Kompisi HTTPS publik URL pada port 443, hingga karakter 2,048. Kelayakan pengguna tidak ada atau fragmen URL. Omit, gunakan null atau string kosong tanpa pemberitahuan. Dalam kelompok, set ini pada setiap pertanyaan, param luar.Default:
Tidak Diset
Hasil hasil penghitungan
params.max_resultsinteger / Pilihan- Hasil yang diminta dihitung. Hasil yang lebih sedikit mungkin tersedia.1 Ke 700, nomor bulatDefault:
20
penapis pencarian fanfan
params.filtersobject · nullable / Pilihan- Tanggal muat naik opsional, tipe hasil, durasi, penyortiran dan filter fitur. ¡Omit atau gunakan null untuk tanpa filter.Default:
Tidak Diset params.filters.upload_datestring / Pilihan- Tapis lewat tanggal upload.1 Ke 2,000 aksaraNilai-Nilai:
today / last_hour / this_week / this_month / this_yearDefault:Tidak Diset params.filters.typestring / Pilihan- Filter berdasarkan tipe hasil.1 Ke 2,000 aksaraNilai-Nilai:
video / channel / playlist / movieDefault:Tidak Diset params.filters.durationstring / Pilihan- Filter oleh durasi video dalam menit.1 Ke 2,000 aksaraNilai-Nilai:
<4 / 4-20 / >20Default:Tidak Diset params.filters.sort_bystring / Pilihan- Hasil pesanan. Omit untuk menggunakan pemesanan standar YouTube.1 Ke 2,000 aksaraNilai-Nilai:
rating / relevance / view_count / upload_dateDefault:Tidak Diset params.filters.360boolean / Pilihan- **Ditetapkan* true Untuk kebutuhan 360 feature.
trueOR atau ORANGfalseDefault:Tidak Diset params.filters.3dboolean / Pilihan- Waidine Set true untuk membutuhkan fitur 3d.
trueOR atau ORANGfalseDefault:Tidak Diset params.filters.4kboolean / Pilihan- Diagnosa Set true untuk membutuhkan fitur 4k.
trueOR atau ORANGfalseDefault:Tidak Diset params.filters.creative_commonsboolean / Pilihan- Diagnosis Set true untuk membutuhkan fitur creative commons.
trueOR atau ORANGfalseDefault:Tidak Diset params.filters.hdboolean / Pilihan- XAVN Set true untuk membutuhkan fitur hd.
trueOR atau ORANGfalseDefault:Tidak Diset params.filters.hdrboolean / Pilihan- XAVN Set true untuk membutuhkan fitur hdr.
trueOR atau ORANGfalseDefault:Tidak Diset params.filters.liveboolean / Pilihan- Diafne Set true untuk membutuhkan fitur langsung.
trueOR atau ORANGfalseDefault:Tidak Diset params.filters.locationboolean / Pilihan- XAVN Set true untuk membutuhkan fitur lokasi.
trueOR atau ORANGfalseDefault:Tidak Diset params.filters.purchasedboolean / Pilihan- Xanevia Set true untuk membutuhkan fitur yang dibeli.
trueOR atau ORANGfalseDefault:Tidak Diset params.filters.subtitlesboolean / Pilihan- Xanequish Set true untuk membutuhkan fitur subtitles.
trueOR atau ORANGfalseDefault:Tidak Diset params.filters.vr180boolean / Pilihan- Diagnosa Set true untuk membutuhkan fitur vr180.
trueOR atau ORANGfalseDefault:Tidak Diset
Respons
Kembali Realtime status: done. Baca output sumber di results[0].results; usage.credits Catatan catatan biaya.
Keluaran pencarian lema berisi pertanyaan, totalResults dan item yang dikembalikan. totalResults menghitung item respon ini; itu bukan jumlah total video pencocokan pada YouTube.
Baca hasilnya
Simpan respon JSON yang sukses sebagai response.json. Simpan ini sebagai read-response.py dan jalankan python read-response.py. Ini hanya menggunakan perpustakaan standar Python dan tidak membuat permintaan baru.
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 default ke 20 dan menerima 1 ke 700. Ini adalah satu permintaan pencarian yang lebih besar, bukan 700 yang memisahkan pekerjaan kelompok. Permintaan yang lebih besar dapat memakan waktu lebih lama; sinkronisasi menghindari menjaga koneksi pengirim tetap terbuka.
Filter milik params.filters. Hasil yang lebih sedikit mungkin tersedia, dan ladang barang yang kaya dapat berupa null atau tidak hadir. Extended Search memiliki tingkat penggunaan sendiri.
Semua medan respon
| Ukrainian | Keterangan |
|---|---|
sourcestring | Sumber API yang diminta. |
statusstring | Hal ini dilakukan ketika permintaan realtime berhasil. |
created_atstring | Waktu penciptaan responsi kreasi dalam format ISO 8601. |
usage.creditsnumber | Penghargaan atas permintaan itu, berdasarkan rencanamu. |
results[0].querystring | Pertanyaan pencarian. |
results[0].totalResultsinteger | Jumlah hasil yang dikembalikan. |
results[0].resultsarray | Hasil pencarian dari hasil pencarian mereka kembali. |
results[0].results[].videoIdstring | Video YouTube ID. |
results[0].results[].titlestring | Video judul. |
results[0].results[].channelstring | Nama saluran. |
results[0].results[].channelIdstring · nullable | Saluran ID bila tersedia. |
results[0].results[].channelUrlstring · nullable | Saluran URL bila tersedia. |
results[0].results[].durationnumber · nullable | Durasi video dalam hitungan detik. |
results[0].results[].durationStringstring · nullable | Video yang diformat ketika tersedia. |
results[0].results[].viewCountnumber · nullable | View count bila tersedia. |
results[0].results[].uploadDatestring · nullable | Tanggal muat naik bila tersedia. |
results[0].results[].descriptionstring · nullable | Keterangan experpt, hingga 500, atau null ketika tidak tersedia. |
results[0].results[].thumbnailsarray | Thumbnail URLs dan dimensi. |
Bidang-bidang di atas menggambarkan respon JSON baku. JSON, teks polos dan Markdown format.
Async 2) mengembalikan satu penerimaan kerja; batch mengembalikan satu per Pertanyaan lema. Periksa status masing-masing pekerjaan dan mendapatkan hasilnya dengan menggunakan link yang dikembalikan.
Zavous Async & batch lifecycle
Surat penyerahan mengembalikan penerimaan, bukan hasil. Async menciptakan satu pekerjaan; batch mengembalikan pekerjaan yang terpisah dalam queries[] Untuk setiap pertanyaan yang diterima. Track dan mendapatkan setiap pekerjaan secara independen.
Diserahkan ke data.flashdata.dev; baca status pekerjaan dan hasil dari api.flashdata.dev Dan X-API-Key yang sama. Contoh dasar API terkait menggunakan Python dan cURL.
1. Simpan pekerjaan IDs
¡Holfi mempertahankan ruas permintaan sumber ini ketika beralih ke Async. Untuk Batch, letakkan setiap permintaan di dalam array kueri dari objek JSON. Simpan setiap pekerjaan yang dikembalikan ID.
2. Periksa status
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: jajak pendapat dengan penundaan dan rasa hormatRetry-AfterKetika hadir.completed: Hasil tangkapan.failed: [ : ] inspeksijob.error.Read job.status, bukan status penerimaan.
Periksa status · Python dan cURL
Referensi API status Job3. Hasil kutipan
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsSelepas selesai, sahkan akses untuk membaca hasil, kemudian ambil URL storan daripada 302 tanpa kunci API anda. Simpan JSON dalam masa 24 jam selepas selesai.
Hasil kutip · Python dan cURL · Format respons
Hasil pengambilan gambar referensi API
Pengejaan dan pengambilan hasil yang sudah ada tidak mengkonsumsi kredit pertanyaan. TOPN TPS tidak membatalkan pekerjaan: menjaga ID daripada mengajukan pekerjaan yang dapat ditagih. Kode galat dan perilaku coba ulang dan kode galat.
Webhook penyelesaian
Langganan per pertanyaan
**Ditetapkan* callback_url Di tingkat atas dari permintaan async, atau lema di dalam setiap pertanyaan Di dalam kelompok, di luar params. Tidak ada permintaan pendaftaran-keuskupan webhook terpisah yang diperlukan. Permintaan Realtime tidak mengirim callback.
Use a public HTTPS URL di port 443. FlashData POSTs sebuah pemberitahuan untuk setiap jangkauan pekerjaan completed OR atau ORANG failed; BARV; acara tersebut berisi tautan, bukan hasil itu sendiri.
Mengakui dan memverifikasi
AWAS 2xx Setelah menerima acara itu dengan baik. Duakan duplikasi oleh delivery_id, Dan dikirim sebagai.. X-Delivery-Id. Redirect tidak diikuti.
Pengiriman Gagal dicoba dengan pengunduran eksponensial, hingga Total percobaan 8 Zain dan paling banyak 24 jam sesudah selesai. Tetap melakukan pemungutan suara sebagai kemunduran.
Panggilan balik tidak ditandatangani. Konfirmasi pekerjaan ID, sumber dan status terminal melalui Titik akhir status tersahihkan Bekal sebelum memproses pemberitahuan. Kiriman ID adalah untuk deduksi, bukan bukti keaslian.
Contoh senam webhook peristiwa dan bidang
{
"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"
}
]
}| Ukrainian | Keterangan |
|---|---|
delivery_idstring | Pengenal pengiriman yang stabil. Pemberitahuan dundaplikasi menggunakan nilai ini; juga dikirim dalam header X-Delivery-Id. |
idstring | Yob ID. |
sourcestring | Sumber data yang dimintakan oleh KANTOR. |
statusstring | Gagal atau gagal. |
linksarray | Status dan hasil link. Pemakluman kata nifaks tidak termasuk konten hasil atau kunci API. |
links[].relstring | Kegandirian atau hasil. |
links[].hrefstring | Manajemen Absolute API URL; sahihkan dengan kunci API anda. |
links[].methodstring | GET. |
Pemulihan Galat
Jika permintaan yang sering muncul, penerimaan mungkin tidak pasti. Periksa sejarah pekerjaan sebelum mengirim kembali. Untuk pencarian besar berikutnya, pilih async dan lacak ID yang dikembalikan.
Untuk autentikasi, keseimbangan, permintaan-format dan tingkat-batas kegagalan, gunakan referensi kesalahan bersama. Pengerahan surat perintah mungkin masih menciptakan pekerjaan; memeriksa pekerjaan yang sudah ada sebelum mencoba lagi.
Ralat dan kod status · Bila hendak mencoba lagi · Batasan kadar laklak
Panduan langkah demi langkah: \"Merencanakan pencarian calon yang lebih besar\"