Belgeleri incele
API başvurusu
YouTube Search API
Arama YouTube videoları anahtar kelime ve sıralama başlıkları, kanallar, süreler, görüş sayıları ve JSON olarak başlanır.
İstek oluştur
Geri dönmek için en fazla arama sonuçları.
Gelişmiş parametreler
https://data.flashdata.dev/v1/queries/realtimeParametreler
Send Send Gönder source Ve ve query Üst düzeyde. Kaynak seçenekleri içeri girer params. Seçmeli alanlar ihmal edilebilir.
İstek gövdesi
sourcestring / Zorunlu- youtube_search'a ayarlayın.
querystring / Zorunlu- Arama sorgusu.1 To to to to için 2.000 karakterler karakterler karakterlerVarsayılan:
Set Not set Not set paramsobject / İsteğe bağlı- Settings bu istek için.Varsayılan:
{} callback_urlstring · nullable / İsteğe bağlı- Async ve sadece toplu. Halk Halk Halkı HTTPS Tamam tamamlanma tamamlanma tamamlanma tamamlandı URL limanda 443, yukarı 2,048 karakterler. Kullanıcı Bilgileri veya URL parçaları yok. Omit, null veya bildirim için boş bir dize kullanın. Bir partide, bunu her sorguda, params dışında ayarlayın.Varsayılan:
Set Not set Not set
Sonuç sayısı
params.max_resultsinteger / İsteğe bağlı- İstekli sonuç sayımı. Daha az sonuçlar kullanılabilir olabilir.1 To to to to için 20, Tüm sayılarVarsayılan:
20
Arama filtreleri
params.filtersobject · nullable / İsteğe bağlı- Seçmeli yükleme tarihi, sonuç türü, süresi, sıralama ve özellik filtreleri. Omit veya null'u filtreler için kullanın.Varsayılan:
Set Not set Not set params.filters.upload_datestring / İsteğe bağlı- Filtre, tarih yükleme ile filtre.1 To to to to için 2.000 karakterler karakterler karakterlerDeğerler:
today / last_hour / this_week / this_month / this_yearVarsayılan:Set Not set Not set params.filters.typestring / İsteğe bağlı- Sonuç türü ile filtre.1 To to to to için 2.000 karakterler karakterler karakterlerDeğerler:
video / channel / playlist / movieVarsayılan:Set Not set Not set params.filters.durationstring / İsteğe bağlı- Video süresi ile dakikalar içinde filtre.1 To to to to için 2.000 karakterler karakterler karakterlerDeğerler:
<4 / 4-20 / >20Varsayılan:Set Not set Not set params.filters.sort_bystring / İsteğe bağlı- Sonuç siparişi. YouTube'un varsayılan siparişini kullanmak için Omit.1 To to to to için 2.000 karakterler karakterler karakterlerDeğerler:
rating / relevance / view_count / upload_dateVarsayılan:Set Not set Not set params.filters.360boolean / İsteğe bağlı- Set Set Set true gerektirmektedir. 360 özellik.
trueveya veya veyafalseVarsayılan:Set Not set Not set params.filters.3dboolean / İsteğe bağlı- true'u 3d özelliği gerektirir.
trueveya veya veyafalseVarsayılan:Set Not set Not set params.filters.4kboolean / İsteğe bağlı- true'u 4k özelliği gerektirir.
trueveya veya veyafalseVarsayılan:Set Not set Not set params.filters.creative_commonsboolean / İsteğe bağlı- true'u yaratıcı ortakların özelliklerini gerektirir.
trueveya veya veyafalseVarsayılan:Set Not set Not set params.filters.hdboolean / İsteğe bağlı- true'u HD özelliği gerektirir.
trueveya veya veyafalseVarsayılan:Set Not set Not set params.filters.hdrboolean / İsteğe bağlı- true'u, HDr özelliğini gerektirir.
trueveya veya veyafalseVarsayılan:Set Not set Not set params.filters.liveboolean / İsteğe bağlı- true'u canlı özelliği gerektirir.
trueveya veya veyafalseVarsayılan:Set Not set Not set params.filters.locationboolean / İsteğe bağlı- true'u yer özelliğini gerektirir.
trueveya veya veyafalseVarsayılan:Set Not set Not set params.filters.purchasedboolean / İsteğe bağlı- true'u satın alınan özelliği gerektirir.
trueveya veya veyafalseVarsayılan:Set Not set Not set params.filters.subtitlesboolean / İsteğe bağlı- true'u alt başlıklar özelliği gerektirir.
trueveya veya veyafalseVarsayılan:Set Not set Not set params.filters.vr180boolean / İsteğe bağlı- true'u vr180 özelliği gerektirir.
trueveya veya veyafalseVarsayılan:Set Not set Not set
Yanıt
Realtime döndürür status: done. Kaynak çıktısını okuyun results[0].results; usage.credits Yükyü kaydeder.
Arama çıktı sorgu içerir, totalResults ve geri dönüş eşyaları. totalResults döndü, YouTube'nun toplam eşleştirme kataloğu değil.
Sonuç okuyun
JSON yanıtını response.json olarak kurtarın. Bunu read-response.py olarak kaydedin ve python read-response.py çalıştırın. Sadece Python'un standart kütüphanesini kullanır ve yeni bir istek yapmaz.
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 Varsayılan olarak varsayılanlar 20 Kabul ve kabul et 1 To to to to için 20. Genişletilmiş Arama, 700'ye ayrı bir kullanım oranıyla destek vermektedir.
Filtreler params.filters'da ait, params dışında değil. YouTube'un varsayılan davranışını kullanmak için Omit filtreleri. İade edilen öğe ayrıntıları, sonuç türü ve kullanılabilirliğe bağlıdır.
Tüm yanıt alanları
| Field | Description Description Description |
|---|---|
sourcestring | Talep edilen API kaynağı. |
statusstring | Gerçek zamanlı istek başarılı olduğunda yapılır. |
created_atstring | ISO 8601 formatındaki arama süresi. |
usage.creditsnumber | Krediler talep için ücretlendirilir, planınıza göre. |
results[0].querystring | Arama sorgusu. |
results[0].totalResultsinteger | Sonuçlar sayısı geri döndü. |
results[0].resultsarray | Arama sonuçları geri dönüşlerinde. |
results[0].results[].videoIdstring | YouTube video ID. |
results[0].results[].titlestring | Video unvanı. |
results[0].results[].channelstring | Kanal adı. |
results[0].results[].channelIdstring · nullable | Kanal ID mevcut olduğunda. |
results[0].results[].channelUrlstring · nullable | Kanal URL mevcut olduğunda. |
results[0].results[].durationnumber · nullable | Video süresi saniyede. |
results[0].results[].durationStringstring · nullable | Mevcut olduğunda formatlanmış video süresi. |
results[0].results[].viewCountnumber · nullable | Mevcut olduğunda sayı sayın. |
results[0].results[].uploadDatestring · nullable | Mevcut olduğunda yükleme tarihi. |
results[0].results[].descriptionstring · nullable | Açıklama, 500 karakterlere veya null'ye kadar, kullanılamazken. |
results[0].results[].thumbnailsarray | katnail URLs ve boyutları. |
Yukarıdaki alanlar varsayılan JSON yanıtını tanımlar. JSON, düz metin ve Markdown formatları.
Async bir iş makbu döndürür; toplu bir iş başına döndürür Soru Soru Soru. Her işin durumunu kontrol edin ve geri dönüş bağlantıları kullanarak sonuçlarını alın.
Async & toplu yaşam döngüsü
Submission bir makbuz döndürür, sonuç vermez. Async bir iş yaratır; toplu ayrı bir iş döndürür queries[] Her kabul edilen sorgu için. Her işi bağımsız olarak takip edin ve alın.
Göndermeye yemin ederim data.flashdata.dev; İş durumunu ve sonuçlarını okuyun api.flashdata.dev Aynı X-API-Key ile. bağlantılı API temelleri Python ve cURL kullanır.
1. İşi kurtarmak IDs
Bu kaynağın Async'ye geçiş yaparken istek alanları tut. Batch için, her isteği bir JSON nesnesinin sorgu dizi içine koyun. Her geri dönüş işi ID’yu kurtarın.
2. Check durumu kontrol
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: Bir gecikme ve saygı ile anketRetry-AfterŞu anda.completed: Sonuçlar getir.failed: denetimjob.error.job.status'u okuyun, teslim makbunun statüsü değil.
İş durumu API referans3. Fetch sonuçları
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsTamamlandıktan sonra, sonuç okumasını gerçekle, sonra 302 depolama URL'yu API anahtarınız olmadan getirin. JSON'u 24 saat içinde kurtarın.
Fetch sonuçları · Python ve cURL · Yanıt biçimleri
Sonuç indir API referans
Mevcut sonuçları araştırmak ve getirmek sorgu kredilerini tüketmiyor. Bir anket süresi işi iptal etmez: Tekrarlanan faturalı işi sunmak yerine ID'yu tut. Hata kodları ve yeniden deneme davranışı.
Tamamlanma webhook’ları
Sorgu başına abone olun
Set Set Set callback_url Bir amin talebinin üst seviyesinde veya Her sorgunun içinde Bir partide, dışarıda params. Ayrı bir webhook kayıt isteği gerekmez. Realtime talepleri çağrıları göndermez.
HTTPS URL port 443. FlashData POSTs her iş için bir bildirim completed veya veya veya failed; Olay bağlantıları içeriyor, sonucun kendisi değil.
Abilgi ve doğrulama
Return Return Return dön 2xx Olayı kabul ettikten sonra. Deduplicate Tarafından delivery_id, Ayrıca, da gönderiler X-Delivery-Id. Emekliler takip edilmez.
Başarısız teslimatlar, üst üste tekrar tekrar tekrar deneme, yukarı yukarı yukarı 8 toplam denemeler Ve çoğu zaman 24 saatler tamamlandıktan sonra. Bir düşüş olarak ankete devam edin.
Callbacks imzalanmamış. İş ID, kaynak ve terminal statüsünü onaylayın Gerçekleştirilmiş durum uç noktası bildirimi işlemeden önce. Teslimat ID, gerçekliğin kanıtı değildir.
Örnek webhook olayı ve alanları
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "youtube_search",
"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"
}
]
}| Field | Description Description Description |
|---|---|
delivery_idstring | Stable teslimat tanımlayıcısı. Bu değeri kullanarak bildirimleri karmaşıklaştırın; aynı zamanda X-Delivery-Id başlığında da gönderilir. |
idstring | İş ID. |
sourcestring | Talep edilen veri kaynağı. |
statusstring | Tamamlanan veya başarısız oldu. |
linksarray | Durum ve sonuç bağlantıları. Bildirimler sonuç içeriğini veya API anahtarını içermez. |
links[].relstring | Kendi veya sonuçları. |
links[].hrefstring | Mutlak Yönetim API URL; API anahtarınızla ilgili. |
links[].methodstring | GET. |
Hata kurtarma
Başarılı bir arama, talep edilenden daha az eşya geri dönebilir. Rahat filtreler veya başka bir istek sunmadan önce sorguyu ayarlama; boş bir sonuç kendi bir iş başarısızlığı değildir.
Doğrulama için, denge, istek-format ve oran-limit başarısızlıkları, paylaşılan hata referansını kullanın. Bir teslim süresi hala bir iş yaratabilir; yeniden denemeden önce mevcut işleri kontrol edin.
Hatalar ve durum kodları · Yeniden deneme ne zaman · Puan limitleri
Step-by-step rehberi: Bir konu için videoları bulun
Fiyatlandırma
| Planlar | Kullanım oranları1.000 standart istek başına | Abonelik Aboneliği | Fatura dönemi için krediler dahil |
|---|---|---|---|
| Kullandıkça öde | $0,50 | Aylık ücret yok | Gerektiğinde bakiye ekleyin |
| Micro | $0,40 | $49,00 / ay ay ay | 1.000 kredileri ($50,00 of API kullanımı) |
| Starter | $0,35 | $199,00 / ay ay ay | 4.000 kredileri ($200,00 of API kullanımı) |
| Pro | $0,30 | $499,00 / ay ay ay | 10.000 kredileri ($500,00 of API kullanımı) |
| Scale | $0,25 | $999,00 / ay ay ay | 20.000 kredileri ($1.000,00 of API kullanımı) |
| Business | $0,20 | $1.999,00 / ay ay ay | 40.000 kredileri ($2.000,00 of API kullanımı) |
Tek hesap planı. Üç üründe ortak kredi bakiyesi. Plana dahil kredilerle karşılanan kullanım yeniden ücretlendirilmez.
Mevcut fiyatlar ve plan limitleri