Whatever format you ask for, a failure comes back as the JSON error envelope, so your client can always read status first.
Output formats
Results come as JSON by default. Set format to get the same result as Markdown for language models, or, on Google Search, the results page itself as HTML. The price is the same.
format
| Value | What you get |
|---|---|
json | Default. The parsed result in the standard envelope: status, credits_charged, request_id and the result fields. |
markdown | The same result as Markdown text (text/markdown), ready to hand to a language model: no envelope, no duplicate fields, no inline images. |
raw | Google Web Search only: the results page itself as text/html, with tracking scripts removed and result links resolved to their real addresses. |
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"}'