Google Videos Search — Referencia de API

POST

Disponible

/google/videos/search

Videos

Busca listados de videos de Google; no descarga videos ni elimina marcas de agua.

type

videos

result

videos

Facturacion

1 credits

Busca listados de videos de Google; no descarga videos ni elimina marcas de agua.

Parametros

CampoTipoDisponibilidadDescripcion

q

requerido

string

requerido

Texto de busqueda.

hl

opcional

string

opcional

Codigo de idioma. Predeterminado: en.

gl

opcional

string

opcional

Codigo de pais. Predeterminado: us.

page

opcional

number

opcional

Numero de pagina desde 1. Predeterminado: 1.

query

ejemplo

string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "how espresso machines work"

json

{
  "query": "how espresso machines work"
}

Abrir en Playground

Campos de respuesta

CampoTipoDisponibilidadDescripcion

query

requerido

string

requerido

Consulta normalizada de la solicitud.

page

requerido

number

requerido

Numero de pagina actual desde 1.

videos

opcional

VideoResult[]

Cuando se analizan videos.

Resultados de Google Videos.

VideoResult Schema de item

CampoTipoDisponibilidadDescripcion

rank

requerido

number

requerido

Posicion de ranking desde 1 en esta respuesta.

position

opcional

number

Alias de rank cuando esta disponible.

Alias normalizado para clientes que esperan position.

title

requerido

string

requerido

Titulo del resultado.

link

requerido

string

requerido

Enlace principal devuelto por el parser.

url

opcional

string

Presente cuando el enlace se puede normalizar.

URL canonica de destino, normalmente igual a link.

source_url

opcional

string

Solo cuando se observa una URL fuente de Google.

URL original de Google para depuracion y procedencia.

display_url

opcional

string

Cuando se deriva texto visible o dominio.

URL visible o dominio fuente.

source

opcional

string

Cuando se puede analizar origen o canal.

Origen o canal del video.

duration

opcional

string

Cuando aparece duración en el resultado.

Texto de duración del video.

time

opcional

string

Cuando se puede analizar la fecha de publicación.

Texto original de fecha de publicación.

published_at

opcional

string

Alias del tiempo analizado, si existe.

Alias normalizado de fecha de publicación.

thumbnail_url

opcional

string

Cuando Google expone una miniatura.

URL de miniatura.

thumbnail

opcional

string

Alias de thumbnail_url cuando esta disponible.

Alias normalizado de miniatura.

Ejemplos de código y respuesta

bash

curl -X POST 'https://api.serpbase.dev/google/videos/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"how espresso machines work"}'

Ejemplo existente de Google

bash

curl -X POST https://api.serpbase.dev/google/videos/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "python asyncio tutorial",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'

Notas

Busqueda de video, tutoriales y monitoreo.

Si no hay tarjetas de video, se usa extracción de noticias en diseños Google compatibles.