---
title: "Google Search (x402)"
method: GET
path: "/x402/v2/google-search"
tags: ["x402"]
---

# Google Search (x402)

`GET /x402/v2/google-search`

## Request

- Base URL: `https://api.strale.io`
- URL: `https://api.strale.io/x402/v2/google-search`
- Auth: none required

Perform a Google search and return structured results. Returns title, URL, snippet, position for each result.

## Query parameters

- `query` string, required: Search query
- `country` string: Country to scope results to, as an ISO 3166-1 alpha-2 code (MX), alpha-3 code (MEX), numeric code (484), or exact country name (Mexico). "UK" is accepted as an alias for GB. Unrecognised values are rejected before the search runs rather than silently ignored. Omit for unscoped global results.
- `language` string: Language for results, as an ISO 639-1 code ("en"), optionally with a region ("pt-BR"). Validated for shape and rejected before the search runs if malformed, rather than silently ignored. Omit for Google's default.
- `num_results` integer: Number of results (default 10, max 20)

## Response `200`

Success

- object
  - `query` string
  - `results` unknown[]
    - unknown
  - `total_results_estimate` string

## Other responses

- `402`: Payment required (x402 — pay with USDC on Base)

---

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