어떤 형식을 요청해도 실패하면 JSON 오류 구조로 돌아오므로 항상 status를 먼저 읽을 수 있습니다.
출력 형식
결과는 기본적으로 JSON입니다. format을 지정하면 같은 결과를 언어 모델용 Markdown으로, Google 검색에서는 결과 페이지 HTML 그대로 받을 수 있습니다. 가격은 같습니다.
format
| 값 | 받는 내용 |
|---|---|
json | 기본값. 표준 구조(status, credits_charged, request_id)와 결과 필드가 담긴 파싱된 결과. |
markdown | 같은 결과를 Markdown 텍스트(text/markdown)로 반환합니다. 외곽 구조, 중복 필드, 인라인 이미지가 없어 언어 모델에 바로 넘길 수 있습니다. |
raw | Google 웹 검색 전용: 결과 페이지 자체를 text/html로 반환합니다. 추적 스크립트는 제거되고 링크는 실제 주소로 바뀝니다. |
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"}'