SerpBase

Google News Search — Referência da API

POST
Disponível
/google/news/search

Noticias

Busque Google News por tema ou palavras-chave. Artigos e editores dependem da origem.

type
news
result
news
Cobranca
1 credits

Busque Google News por tema ou palavras-chave. Artigos e editores dependem da origem.

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: "semiconductor supply"

json
{
  "query": "semiconductor supply"
}
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.

news
opcional
NewsResult[]

Quando notícias são analisadas.

Resultados do Google Notícias.

NewsResult 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 o editor é analisado.

Rótulo de editor ou origem.

time
opcional
string

Quando Google expõe texto de tempo.

Texto original de publicação.

published_at
opcional
string

Alias do tempo analisado, se existir.

Alias do tempo de publicação normalizado.

snippet
opcional
string

Quando um trecho é analisado.

Trecho de resumo do artigo.

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/news/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"semiconductor supply"}'
Exemplo existente do Google
bash
curl -X POST https://api.serpbase.dev/google/news/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "apple event",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
Notas

Monitoramento de marca, tendencias e midia.

Origem e tempo são analisados de metadados compactos do Google; ambos são opcionais.