Explorar documentación
Referencia de la API
YouTube Buscar API
Buscar videos YouTube por palabra clave y recuperar títulos, canales, duración, cuenta de vista y miniaturas como JSON.
Prepara una solicitud
Número máximo de resultados de búsqueda para volver.
Parámetros avanzados
https://data.flashdata.dev/v1/queries/realtimeParámetros
Enviar source y query en el nivel superior. Las opciones de fuentes pertenecen a params. Se pueden omitir campos opcionales.
Solicitud de cuerpo
sourcestring / Obligatorio- Listo para youtube_search.
querystring / Obligatorio- Buscar consulta.1 a 2000 personajesDefault:
Sin definir paramsobject / Opcional- Ajustes para esta solicitud.Default:
{} callback_urlstring · nullable / Opcional- Solo Async y lote. Public HTTPS completion URL en port 443, hasta caracteres 2,048. No hay credenciales de usuario o fragmento URL. Omitir, usar null o una cadena vacía para ninguna notificación. En un lote, establece esto en cada consulta, fuera de los params.Default:
Sin definir
Conteo de resultados
params.max_resultsinteger / Opcional- Se solicita un recuento de resultados. Se pueden obtener menos resultados.1 a 20, números enterosDefault:
20
Filtros de búsqueda
params.filtersobject · nullable / Opcional- Fecha de carga opcional, tipo de resultado, duración, clasificación y filtros de características. Omitir o utilizar null para no filtros.Default:
Sin definir params.filters.upload_datestring / Opcional- Filtrar por la fecha de carga.1 a 2000 personajesValores:
today / last_hour / this_week / this_month / this_yearDefault:Sin definir params.filters.typestring / Opcional- Filtro por tipo de resultado.1 a 2000 personajesValores:
video / channel / playlist / movieDefault:Sin definir params.filters.durationstring / Opcional- Filtrar por duración de vídeo en minutos.1 a 2000 personajesValores:
<4 / 4-20 / >20Default:Sin definir params.filters.sort_bystring / Opcional- Ordenación de resultados. Omitir para usar el pedido predeterminado de YouTube.1 a 2000 personajesValores:
rating / relevance / view_count / upload_dateDefault:Sin definir params.filters.360boolean / Opcional- Establece fiel para requerir la función 360.
trueofalseDefault:Sin definir params.filters.3dboolean / Opcional- Establece fiel para requerir la función 3d.
trueofalseDefault:Sin definir params.filters.4kboolean / Opcional- Establece fiel para requerir la función 4k.
trueofalseDefault:Sin definir params.filters.creative_commonsboolean / Opcional- Es verdad para requerir la función de los comunes creativos.
trueofalseDefault:Sin definir params.filters.hdboolean / Opcional- Establece verdadero para requerir la característica de hd.
trueofalseDefault:Sin definir params.filters.hdrboolean / Opcional- Establece verdadero para requerir la característica de hdr.
trueofalseDefault:Sin definir params.filters.liveboolean / Opcional- Es verdad para exigir la función en vivo.
trueofalseDefault:Sin definir params.filters.locationboolean / Opcional- Establece verdadero para requerir la función de ubicación.
trueofalseDefault:Sin definir params.filters.purchasedboolean / Opcional- Establece fiel para exigir la función comprada.
trueofalseDefault:Sin definir params.filters.subtitlesboolean / Opcional- Es verdad que requiere la función subtítulos.
trueofalseDefault:Sin definir params.filters.vr180boolean / Opcional- Establece fiel para requerir la función vr180.
trueofalseDefault:Sin definir
Respuesta
Realtime devuelve status: done. Lea la salida de la fuente en results[0].results; usage.credits registra la carga.
La salida de búsqueda contiene la consulta, totalResults y los elementos devueltos. totalResults es el número devuelto, no el catálogo total de emparejamiento de YouTube.
Lea el resultado
Guardar la respuesta JSON exitosa como response.json. Guardar esto como read-response.py y ejecutar python read-response.py. Utiliza sólo la biblioteca estándar de Python y no hace ninguna nueva petición.
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 predeterminado a 20 y acepta 1 a 20. Extended Search soporta hasta 700 con una tasa de uso independiente.
Los filtros pertenecen a params.filters, no al lado de los parámetros. Filtros Omit para usar el comportamiento predeterminado de YouTube. Los detalles devueltos del artículo dependen del tipo de resultado y la disponibilidad.
Todos los campos de respuesta
| Campo | Descripción |
|---|---|
sourcestring | La fuente API solicitada. |
statusstring | hecho cuando la solicitud en tiempo real tiene éxito. |
created_atstring | Tiempo de creación de respuestas en formato ISO 8601. |
usage.creditsnumber | Créditos cobrados para la solicitud, basado en su plan. |
results[0].querystring | La consulta de búsqueda. |
results[0].totalResultsinteger | Número de resultados devueltos. |
results[0].resultsarray | Resultados de búsqueda en su orden devuelto. |
results[0].results[].videoIdstring | YouTube video ID. |
results[0].results[].titlestring | Título de vídeo. |
results[0].results[].channelstring | Nombre del canal. |
results[0].results[].channelIdstring · nullable | Canal ID cuando esté disponible. |
results[0].results[].channelUrlstring · nullable | Canal URL cuando esté disponible. |
results[0].results[].durationnumber · nullable | Duración del vídeo en segundos. |
results[0].results[].durationStringstring · nullable | Duración de vídeo con formato cuando esté disponible. |
results[0].results[].viewCountnumber · nullable | Ver cuenta cuando esté disponible. |
results[0].results[].uploadDatestring · nullable | Actualizar la fecha cuando esté disponible. |
results[0].results[].descriptionstring · nullable | Descripción extracto, hasta caracteres 500, o null cuando no está disponible. |
results[0].results[].thumbnailsarray | Thumbnail URLs y dimensiones. |
Los campos arriba describen la respuesta predeterminada JSON. JSON, texto plano y formatos Markdown.
Async devuelve un recibo de trabajo; el lote devuelve uno por query. Compruebe el estado de cada trabajo y recuperar sus resultados utilizando los enlaces devueltos.
Ciclo de vida de solicitudes asíncronas y por lotes
La presentación devuelve un recibo, no resultados. Async crea un trabajo; lote devuelve un trabajo separado en queries[] para cada consulta aceptada. Rastrear y recuperar cada trabajo de forma independiente.
Presentarse data.flashdata.dev; read job status and results from api.flashdata.dev con el mismo X-API-Key. Los ejemplos relacionados API utilizan Python y cURL.
1. Guardar el trabajo IDs
Mantenga los campos de solicitud de esta fuente al cambiar a Async. Para Batch, ponga cada solicitud dentro de la matriz de consultas de un objeto JSON. Ahorre cada trabajo devuelto ID.
2. Compruebe el estado
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: encuesta con un retraso y respetoRetry-Aftercuando esté presente.completed: resultados de búsqueda.failed: inspectivajob.error.Lea job.status, no el estado del recibo de la comunicación.
Estado de comprobación · Python y cURL
Estado de trabajo API referencia3. Resultados de los embragues
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsDespués de la finalización, autentique el resultado leído, después busque el almacenamiento 302 URL sin su llave API. Guarde el JSON dentro de las horas de terminación 24.
Resultados de búsqueda · Python y cURL · Formatos de respuesta
Resultado de la descarga API
Votar y buscar los resultados existentes no consumen créditos de consulta. Un tiempo de votación no cancela el trabajo: mantener su ID en lugar de enviar trabajo facturable duplicado. Códigos de error y comportamiento de reingreso.
Completion webhooks
Suscríbete por consulta
Set callback_url en el nivel superior de una solicitud de asinc, o dentro de cada consulta en un lote, afuera paramsNo se requiere ninguna solicitud de registro de webhook separada. Las solicitudes Realtime no envían llamadas.
Utilice un HTTPS URL público en el puerto 443. FlashData POSTs una notificación para cada trabajo que alcance completed o failed; el evento contiene enlaces, no el resultado mismo.
Reconocimiento y verificación
Regreso 2xx después de aceptar duramente el evento. Deduplicado delivery_id, también enviado como X-Delivery-IdNo se siguen las redirecciones.
Entregas fallidas de nuevo con retroceso exponencial, hasta 8 intentos totales y en la mayoría 24 horas después de la terminaciónSigue sondeando como un retroceso.
Los callbacks no son firmados. Confirme el trabajo ID, fuente y estado terminal a través del punto final de estado autenticado antes de procesar la notificación. La entrega ID es para la deduplicación, no prueba de autenticidad.
Ejemplo de evento webhook y campos
{
"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"
}
]
}| Campo | Descripción |
|---|---|
delivery_idstring | Identificador de entrega estable. Notificaciones deduplicadas utilizando este valor; también se envía en el encabezado X-Delivery-Id. |
idstring | Job ID. |
sourcestring | Solicitud de fuente de datos. |
statusstring | completado o fallado. |
linksarray | Enlaces de estado y resultados. Las notificaciones no incluyen el contenido de resultados o una clave API. |
links[].relstring | auto o resultados. |
links[].hrefstring | Gestión Absoluta API URL; autentique con su llave API. |
links[].methodstring | GET. |
Recuperación de errores
Una búsqueda exitosa puede devolver menos elementos de lo solicitado. Relaje los filtros o ajuste la consulta antes de enviar otra solicitud; un resultado vacío no es en sí mismo una falla de trabajo.
Para la autenticación, equilibrio, formato de solicitud y fallos de tipo límite, utilice la referencia de error compartido. Un tiempo de presentación puede todavía haber creado un trabajo; comprobar el trabajo existente antes de volver a iniciar.
Errores y códigos de estado · Cuándo volver a entrar · Límites de solicitudes
Guía paso a paso: Buscar vídeos para un tema
Precios
| Planes | Tarifas de usosolicitudes estándar 1,000 | Suscripciones | Créditos incluidos por período de facturación |
|---|---|---|---|
| Pago por uso | 0,50 US$ | Sin cuota mensual | Añade créditos cuando los necesites |
| Micro | 0,40 US$ | 49,00 US$ / mes | Créditos 1000 (50,00 US$ de uso API) incluidos |
| Starter | 0,35 US$ | 199,00 US$ / mes | Créditos 4000 (200,00 US$ de uso API) incluidos |
| Pro | 0,30 US$ | 499,00 US$ / mes | Créditos 10.000 (500,00 US$ de uso API) incluidos |
| Scale | 0,25 US$ | 999,00 US$ / mes | Créditos 20.000 (1000,00 US$ de uso API) incluidos |
| Business | 0,20 US$ | 1999,00 US$ / mes | Créditos 40.000 (2000,00 US$ de uso API) incluidos |
Un plan de cuenta. Créditos compartidos en los tres productos. El uso cubierto por créditos incluidos no se cobra de nuevo.
Precios actuales y límites de los planes