Perform a Google search and return structured results

Perform a Google search and return structured results. Returns title, URL, snippet, position for each result. Google search SERP results for AI agents: organic results as clean JSON, scoped by country (ISO 3166) and language (ISO 639-1), up to 20 results per call.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://websearch.use.x402atlas.com/google-search

Our checks, last 30 days

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "country": "US",
    "language": "en",
    "num_results": 10,
    "query": "best electric cars 2026"
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "country": {
              "description": "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.",
              "maxLength": 64,
              "type": "string"
            },
            "language": {
              "description": "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.",
              "pattern": "^[A-Za-z]{2}(-[A-Za-z]{2})?$",
              "type": "string"
            },
            "num_results": {
              "default": 10,
              "description": "Number of results (default 10, max 20)",
              "maximum": 20,
              "minimum": 1,
              "type": "integer"
            },
            "query": {
              "description": "Search query",
              "maxLength": 400,
              "type": "string"
            }
          },
          "required": [
            "query"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "country": {
              "description": "Resolved ISO 3166-1 alpha-2 code the results were scoped to, upper-case; absent when unscoped",
              "type": "string"
            },
            "language": {
              "description": "Result language used, lower-case; absent when Google's default was used",
              "type": "string"
            },
            "note": {
              "description": "Present only on a sample response (empty/omitted query): a hint to pass a real query. The paid request ran; no search was made.",
              "type": "string"
            },
            "queried_at": {
              "description": "Time the search was executed (UTC)",
              "format": "date-time",
              "type": "string"
            },
            "query": {
              "description": "Echoed search query (trimmed)",
              "type": "string"
            },
            "results": {
              "description": "Organic results in ranking order; empty when nothing matched (still HTTP 200)",
              "items": {
                "properties": {
                  "position": {
                    "description": "1-based rank on the results page",
                    "type": "integer"
                  },
                  "snippet": {
                    "description": "Result snippet as shown by Google; may be empty",
                    "type": "string"
                  },
                  "title": {
                    "description": "Result title",
                    "type": "string"
                  },
                  "url": {
                    "description": "Result URL",
                    "type": "string"
                  }
                },
                "required": [
                  "position",
                  "title",
                  "url",
                  "snippet"
                ],
                "type": "object"
              },
              "type": "array"
            }
          },
          "required": [
            "queried_at",
            "query",
            "results"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON