Saltar al contenido
ES
Obtener clave API
Explorar documentación

Referencia de la API

Google Videos API

Obtén una clave API

Encuentra videos en sitios web con Google Videos. Recupera títulos, enlaces de vídeo, miniaturas, duración e información de origen.

Prepara una solicitud

Parámetros avanzados

Empieza en 1. Cada página es una solicitud separada.

Filtro de tiempo Google, como qdr:d durante el pasado día.

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": "google_videos",
    "query": "me at the zoo",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
    },
}

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))
Resultados en la respuesta HTTPautenticación X-API-Key

Pará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 google_videos.
querystring / Obligatorio
Soporta a los operadores de búsqueda Google como el sitio: e intitle:.
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

País, idioma y ubicación

params.glstring / Opcional
Código de dos letras, como nosotros, gb, de o sg. Establecer explícitamente para seleccionar un país.
Exactamente 2 personajesDefault: Sin definir
Formato aceptado^[A-Za-z]{2}$
params.hlstring / Opcional
Google idioma de interfaz. Establecer explícitamente para seleccionar un idioma.
1 a 35 personajesDefault: Sin definir
Formato aceptado^[A-Za-z0-9-]+$
params.locationstring / Opcional
Solicitud de ubicación de búsqueda, preferiblemente una ciudad, como "London, England, United Kingdom". La disponibilidad depende del tipo de búsqueda.
1 a 200 personajesDefault: Sin definir

Pagination

params.numinteger / Opcional
Cuento de resultado solicitado. FlashData no añade un defecto fijo cuando se omitió. El recuento devuelto puede diferir por tipo de consulta y búsqueda.
1 a 100, números enterosDefault: Sin definir
params.pageinteger / Opcional
Página de resultado solicitada. Establecer explícitamente. Cada página es una solicitud API separada.
1 a 100, números enterosDefault: Sin definir

Filtros de búsqueda

params.tbsstring / Opcional
Solicitar filtros de búsqueda Google, como qdr:d para el día pasado o qdr:w para la semana pasada. Disponibilidad depende del tipo de búsqueda.
1 a 200 personajesDefault: Sin definir
params.autocorrectboolean / Opcional
Solicitar corrección de ortografía con verdadero o solicitarlo deshabilitado con falso. El comportamiento aplicado depende del tipo de búsqueda; omitir para usar el comportamiento de Google.
true o falseDefault: Sin definir

Respuesta

Realtime devuelve status: done con la salida de búsqueda en results[0]. Las coincidencias están en results[0].videos. usage.credits registra la carga.

Los resultados describen vídeos y enlaces a sus páginas; no contienen medios descargables. Los campos de duración, fecha y canal son devueltos según lo dispuesto por Google.

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.

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 = [
    {"title": item.get("title"), "url": item.get("link"), "duration": item.get("duration")}
    for item in result.get("videos", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))

Los campos disponibles dependen del tipo de consulta y búsqueda. Los campos opcionales pueden estar ausentes, y pueden ser devueltos campos adicionales.

El número de artículos devueltos y searchParameters.num pueden diferir de params.num. Utilice el array devuelto para determinar el recuento de resultados real.

Todos los campos de respuesta
CampoDescripción
sourcestringLa fuente API solicitada.
statusstringhecho cuando la solicitud en tiempo real tiene éxito.
created_atstringTiempo de creación de respuestas en formato ISO 8601.
usage.creditsnumberCréditos cobrados para la solicitud, basado en su plan.
results[0].searchParametersobjectLos ajustes de búsqueda reportados por Google, con la consulta registrada como q. Los ajustes devueltos pueden diferir de los valores solicitados.
results[0].videosarrayResultados de la búsqueda de vídeo de Google.
results[0].videos[].titlestringTítulo de vídeo.
results[0].videos[].linkstringPágina de vídeo URL.
results[0].videos[].snippetstring · optionalExtracto de descripción de vídeo.
results[0].videos[].durationstring · optionalDuración de vídeo formada.
results[0].videos[].sourcestring · optionalSitio web de hospedaje.
results[0].videos[].channelstring · optionalPublisher o nombre de canal.
results[0].videos[].datestring · optionalFecha de publicación como muestra Google.
results[0].videos[].imageUrlstring · optionalVideo miniatura URL.
results[0].videos[].positionintegerPosición de resultados.
results[0].videos[].videoUrlstring · optionalVideo URL reportado por Google cuando esté disponible.

Los campos arriba describen la respuesta predeterminada JSON. JSON, texto plano y formatos Markdown.

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. 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.

    Solicitud y recepción de Async · Batch cuerpo de solicitud

  2. 2. Compruebe el estado

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

    pending / processing: encuesta con un retraso y respeto Retry-After cuando esté presente. completed: resultados de búsqueda. failed: inspectiva job.error.

    Lea job.status, no el estado del recibo de la comunicación.

    Estado de comprobación · Python y cURL

    Estado de trabajo API referencia
  3. 3. Resultados de los embragues

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

    Despué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
Ilustración de terminación
{
  "delivery_id": "completion:job_example0001",
  "id": "job_example0001",
  "source": "google_videos",
  "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"
    }
  ]
}
CampoDescripción
delivery_idstringIdentificador de entrega estable. Notificaciones deduplicadas utilizando este valor; también se envía en el encabezado X-Delivery-Id.
idstringJob ID.
sourcestringSolicitud de fuente de datos.
statusstringcompletado o fallado.
linksarrayEnlaces de estado y resultados. Las notificaciones no incluyen el contenido de resultados o una clave API.
links[].relstringauto o resultados.
links[].hrefstringGestión Absoluta API URL; autentique con su llave API.
links[].methodstringGET.

Contrato completo de Webhook y restricciones URL

Recuperación de errores

Una búsqueda completa puede contener menos coincidencias de lo solicitado. gl, hl, ubicación y filtros; campos opcionales de reconocimiento rico pueden estar ausentes.

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: Elija y refina una búsqueda de Google

Precios

PlanesTarifas de usopor 1000 solicitudesSuscripcionesCréditos incluidos por período de facturación
Pago por uso1,00 US$Sin cuota mensualAñade créditos cuando los necesites
Micro0,80 US$49,00 US$ / mesCréditos 1000 (50,00 US$ de uso API) incluidos
Starter0,65 US$199,00 US$ / mesCréditos 4000 (200,00 US$ de uso API) incluidos
Pro0,60 US$499,00 US$ / mesCréditos 10.000 (500,00 US$ de uso API) incluidos
Scale0,50 US$999,00 US$ / mesCréditos 20.000 (1000,00 US$ de uso API) incluidos
Business0,40 US$1999,00 US$ / mesCré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