İçeriğe geç
TR
API anahtarı al
Belgeleri incele

API başvurusu

YouTube Genişletilmiş Arama API

API anahtarı alın

700 YouTube arama sonuçları istek başına, video ayrıntılarıyla, başparmaklar ve arama filtreleri ile.

İstek oluştur

Geri dönmek için en fazla arama sonuçları.

Gelişmiş parametreler
Özellikler
POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_search_extended",
    "query": "python",
    "params": {
        "max_results": 20,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
HTTP yanıtlarında sonuçlarX-API-Key doğrulama

Parametreler

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_extended'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 700, 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.
true veya veya veya falseVarsayılan: Set Not set Not set
params.filters.3dboolean / İsteğe bağlı
true'u 3d özelliği gerektirir.
true veya veya veya falseVarsayılan: Set Not set Not set
params.filters.4kboolean / İsteğe bağlı
true'u 4k özelliği gerektirir.
true veya veya veya falseVarsayılan: Set Not set Not set
params.filters.creative_commonsboolean / İsteğe bağlı
true'u yaratıcı ortakların özelliklerini gerektirir.
true veya veya veya falseVarsayılan: Set Not set Not set
params.filters.hdboolean / İsteğe bağlı
true'u HD özelliği gerektirir.
true veya veya veya falseVarsayılan: Set Not set Not set
params.filters.hdrboolean / İsteğe bağlı
true'u, HDr özelliğini gerektirir.
true veya veya veya falseVarsayılan: Set Not set Not set
params.filters.liveboolean / İsteğe bağlı
true'u canlı özelliği gerektirir.
true veya veya veya falseVarsayılan: Set Not set Not set
params.filters.locationboolean / İsteğe bağlı
true'u yer özelliğini gerektirir.
true veya veya veya falseVarsayılan: Set Not set Not set
params.filters.purchasedboolean / İsteğe bağlı
true'u satın alınan özelliği gerektirir.
true veya veya veya falseVarsayılan: Set Not set Not set
params.filters.subtitlesboolean / İsteğe bağlı
true'u alt başlıklar özelliği gerektirir.
true veya veya veya falseVarsayılan: Set Not set Not set
params.filters.vr180boolean / İsteğe bağlı
true'u vr180 özelliği gerektirir.
true veya veya veya falseVarsayı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 bu cevabın öğelerini sayıyor; YouTube'da toplam eşleşen videolar 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.

read-response.py
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 700. Bu daha büyük bir arama isteği değil, 700 ayrı toplu işler. Büyük istekler daha uzun sürebilir; async, gönderimin bağlantısını açık tutmaktan kaçınır.

Filtreler params.filters'ya ait. Daha az sonuçlar mevcut olabilir ve zengin eşya alanları null veya yok olabilir. Genişletilmiş Arama kendi kullanım oranına sahiptir.

Tüm yanıt alanları
FieldDescription Description Description
sourcestringTalep edilen API kaynağı.
statusstringGerçek zamanlı istek başarılı olduğunda yapılır.
created_atstringISO 8601 formatındaki arama süresi.
usage.creditsnumberKrediler talep için ücretlendirilir, planınıza göre.
results[0].querystringArama sorgusu.
results[0].totalResultsintegerSonuçlar sayısı geri döndü.
results[0].resultsarrayArama sonuçları geri dönüşlerinde.
results[0].results[].videoIdstringYouTube video ID.
results[0].results[].titlestringVideo unvanı.
results[0].results[].channelstringKanal adı.
results[0].results[].channelIdstring · nullableKanal ID mevcut olduğunda.
results[0].results[].channelUrlstring · nullableKanal URL mevcut olduğunda.
results[0].results[].durationnumber · nullableVideo süresi saniyede.
results[0].results[].durationStringstring · nullableMevcut olduğunda formatlanmış video süresi.
results[0].results[].viewCountnumber · nullableMevcut olduğunda sayı sayın.
results[0].results[].uploadDatestring · nullableMevcut olduğunda yükleme tarihi.
results[0].results[].descriptionstring · nullableAçıklama, 500 karakterlere veya null'ye kadar, kullanılamazken.
results[0].results[].thumbnailsarraykatnail 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. 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.

    Async isteği ve makbuz · Batch istek vücut isteği

  2. 2. Check durumu kontrol

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: Bir gecikme ve saygı ile anket Retry-After Şu anda. completed: Sonuçlar getir. failed: denetim job.error.

    job.status'u okuyun, teslim makbunun statüsü değil.

    Check durumu · Python ve cURL

    İş durumu API referans
  3. 3. Fetch sonuçları

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    Tamamlandı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ı
Illustrative tamamlanma bildirim
{
  "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"
    }
  ]
}
FieldDescription Description Description
delivery_idstringStable 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.
sourcestringTalep edilen veri kaynağı.
statusstringTamamlanan veya başarısız oldu.
linksarrayDurum ve sonuç bağlantıları. Bildirimler sonuç içeriğini veya API anahtarını içermez.
links[].relstringKendi veya sonuçları.
links[].hrefstringMutlak Yönetim API URL; API anahtarınızla ilgili.
links[].methodstringGET.

Full webhook sözleşmesi ve URL kısıtlamaları

Hata kurtarma

Büyük bir gerçek zamanlı istek zamanları varsa, kabul belirsiz olabilir. Yeniden göndermeden önce iş tarihini kontrol edin. Sonraki büyük aramalar için, birsen seçin ve geri döndü ID.

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: Daha büyük bir aday arama planı

Fiyatlandırma

Mevcut fiyatlar ve plan limitleri