# Google Search API guides and examples

> Start with a working integration or choose a use case. Every guide follows the same public API contract and links to the full reference when you need exact fields and errors.

gsearch.dev is an independent service and is not affiliated with or endorsed by Google.

## Choose the shortest path to a working search

New to the API? Read the JSON guide first. If you already know the response shape, open the Python or Node.js example and make the request from your server.

The AI agent and RAG guides focus on workflow design, source handling, safety, and the limits of search snippets.

## One public contract across every guide

All examples use POST /api/v1/search, server-side API key authentication, and the same ordered organic result fields. The API supports 239 country codes, 5 language codes, and result pages 1 through 10.

For the complete and current contract, use the API documentation and OpenAPI specification instead of copying assumptions from a guide.

## Next steps

- [Get Google search results as JSON](https://gsearch.dev/guides/google-search-results-json/index.md): Learn how to request organic Google search results as structured JSON, localize queries, handle pages, validate responses, and recover from errors.
- [Google Search API for AI agents](https://gsearch.dev/use-cases/ai-agents/index.md): Give an AI agent controlled Google search access with a small tool contract, server-side credentials, structured results, timeouts, and clear limits.
- [Use Google search in a RAG pipeline](https://gsearch.dev/use-cases/rag/index.md): Use Google search results to discover fresh public sources for RAG, preserve source URLs, fetch full pages separately, deduplicate, and cite evidence.
- [Google Search API with Python](https://gsearch.dev/integrations/python/index.md): Call the gsearch.dev Google Search API from Python with no extra package, keep the key server-side, set a timeout, and handle JSON and HTTP errors.
- [Google Search API with Node.js](https://gsearch.dev/integrations/nodejs/index.md): Call the gsearch.dev Google Search API with Node.js built-in fetch, a server-side key, an explicit timeout, response checks, and safe error handling.
- [Complete API documentation](https://gsearch.dev/docs): Authentication, fields, supported values, limits, responses, and errors.
- [OpenAPI 3.1 specification](https://gsearch.dev/openapi.json): Machine-readable public API contract.