Qualquer que seja o formato pedido, uma falha volta como o envelope de erro JSON, então seu cliente sempre pode ler status primeiro.
Formatos de saída
Os resultados vêm em JSON por padrão. Com format você recebe o mesmo resultado em Markdown para modelos de linguagem ou, no Google Search, a própria página em HTML. O preço é o mesmo.
format
| Valor | O que você recebe |
|---|---|
json | Padrão. O resultado analisado no envelope padrão: status, credits_charged, request_id e os campos. |
markdown | O mesmo resultado como texto Markdown (text/markdown), pronto para um modelo de linguagem: sem envelope, campos duplicados ou imagens. |
raw | Só Google Web Search: a própria página de resultados em text/html, sem scripts de rastreamento e com links resolvidos para o endereço real. |
BASH
curl -X POST https://api.serpbase.dev/google/search \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "coffee shops", "format": "markdown"}'