SerpBase

Google Videos Search — Referência da API

POST
Disponível
/google/videos/search

Videos

Busque listagens de vídeos do Google; não baixa vídeos nem remove marcas-d’água.

type
videos
result
videos
Cobranca
1 credits

Busque listagens de vídeos do Google; não baixa vídeos nem remove marcas-d’água.

Parametros
q
obrigatorio
string

obrigatorio

Texto da busca.

hl
opcional
string

opcional

Codigo de idioma. Padrao: en.

gl
opcional
string

opcional

Codigo do pais. Padrao: us.

page
opcional
number

opcional

Numero da pagina a partir de 1. Padrao: 1.

query
exemplo
string

Exemplo do catálogo; a API valida campos obrigatórios.

exemplo: "how espresso machines work"

json
{
  "query": "how espresso machines work"
}
Abrir no Playground
Campos da resposta
query
obrigatorio
string

obrigatorio

Consulta normalizada da requisicao.

page
obrigatorio
number

obrigatorio

Numero da pagina atual a partir de 1.

videos
opcional
VideoResult[]

Quando vídeos são analisados.

Resultados do Google Vídeos.

VideoResult Schema do item
rank
obrigatorio
number

obrigatorio

Posicao no ranking a partir de 1 nesta resposta.

position
opcional
number

Alias de rank quando disponivel.

Alias normalizado para clientes que esperam position.

title
obrigatorio
string

obrigatorio

Titulo do resultado.

link
obrigatorio
string

obrigatorio

Link principal retornado pelo parser.

url
opcional
string

Presente quando o link pode ser normalizado.

URL canonica de destino, normalmente igual a link.

source_url
opcional
string

Somente quando uma URL fonte do Google e observada.

URL original do Google para depuracao e procedencia.

display_url
opcional
string

Quando texto visivel ou dominio pode ser derivado.

URL visivel ou dominio de origem.

source
opcional
string

Quando é possível analisar origem ou canal.

Origem ou canal do vídeo.

duration
opcional
string

Quando a duração aparece no resultado.

Texto de duração do vídeo.

time
opcional
string

Quando é possível analisar a data de publicação.

Texto original da data de publicação.

published_at
opcional
string

Alias do tempo analisado, se existir.

Alias normalizado da data de publicação.

thumbnail_url
opcional
string

Quando o Google expoe uma miniatura.

URL da miniatura.

thumbnail
opcional
string

Alias de thumbnail_url quando disponivel.

Alias normalizado da miniatura.

Exemplos de código e resposta
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"}'
Exemplo existente do 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

Busca de videos, tutoriais e monitoramento.

Sem cartões de vídeo, usa-se extração de notícias em layouts Google compatíveis.