---
title: "Search Google for web results and snippets with Serper"
method: POST
path: "/v1/serper/search"
tags: ["Proxy"]
---

# Search Google for web results and snippets with Serper

`POST /v1/serper/search`

## Request

- Base URL: `https://api.munition.io`
- URL: `https://api.munition.io/v1/serper/search`
- Auth: none required

Munition Google Search: x402-paid Google web search results for AI agents via Serper. Pay 0.004 USDC per query for organic results (title, link, snippet, position), answer box, knowledge graph, people-also-ask and related searches. Country and language selectable.

## Request body

- SerperSearchInput
  - `q` string, required: Google query.
  - `gl` string: Country code (gl), e.g. us, fr, de.
  - `hl` string: Interface language (hl), e.g. en, fr.
  - `num` integer
  - `page` integer
  - `tbs` string: Time filter, e.g. qdr:d, qdr:w, qdr:m, qdr:y.

## Response `200`

Successful response

- SerperSearchOutput
  - `query` string, required
  - `organic` object[], required
    - `title` string, required
    - `link` string, uri, required
    - `snippet` string
    - `position` integer
    - `date` string
  - `answerBox` object, nullable
  - `knowledgeGraph` object, nullable
  - `peopleAlsoAsk` object[]
  - `relatedSearches` object[]
    - `query` string
  - `meta` object, required
    - `resultCount` integer, required
    - `searchedAt` string, date-time, required

## Other responses

- `400`: Invalid input; rejected before any payment is verified or settled.
- `402`: x402 payment required or settlement failed
- `409`: Idempotency conflict; do not pay again
- `422`: Upstream provider rejected the request after settlement (client-side error); payment is kept, paidCallId returned for reconciliation.
- `502`: Upstream provider failed after settlement; payment is kept, paidCallId returned for reconciliation.

---

[API](https://skmtc.dev/munition/apis/munition-api.md) · [All operations](https://skmtc.dev/munition/apis/munition-api/llms.txt) · [OpenAPI document](https://skmtc.dev/munition/apis/munition-api/revisions/3b11109809d1?raw)