Developer resources

Google Search API guides and examples

Start with a working integration, localized targeting, reliability guidance, or a product use case. Every guide follows the same public API contract.

Published by Mentorsko Ltd on . Last reviewed .

Choose the shortest path to a working search

New to the API? Read the JSON guide first. For a production integration, add the country and language targeting guide and the retry and rate-limit guide.

The Python and Node.js pages provide complete server examples. 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 up to 100 consecutive result pages ending by page 100.

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 Learn how to request organic Google search results as structured JSON, localize queries, handle pages, validate responses, and recover from errors. Google Search API country and language targeting Use Google Search API country and language parameters correctly, compare markets, validate supported codes, and keep localized requests repeatable. Google Search API retries and rate limits Handle Google Search API rate limits, timeouts, and temporary errors with capped retries, response checks, safe delays, and useful request logs. Google Search API for AI agents 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 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 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 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.