Google Search: v1 to v2 migration
Google v2 replaces the v1 Google Search endpoint with richer results, more Google surfaces, and a lower credit cost. The v1 endpoint (/api/v1/google) is deprecated and is retired on August 4, 2026. Move to /api/v2/google before then. Only the Google Search endpoint changes — YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram are unaffected.
Why upgrade
- AI Overviews are included in the response when Google shows one.
- More surfaces, each its own endpoint under
/api/v2/google: AI Mode, Maps, Shopping, Flights, Hotels, News, and Trends. - Cheaper. A full Google search cost 2 credits on v1. v2 returns the full result for 1 credit.
- More complete SERP data (knowledge graph, related questions, top stories, discussions, and more).
What changes
| v1 (deprecated) | v2 | |
|---|---|---|
| Endpoint | POST /api/v1/google | POST /api/v2/google |
| Request body | query plus search_type, country_code, language, light_request, ... | query plus gl, hl, google_domain, device, location, ... (Google-native names) |
| Response shape | Scavio-normalized | Google's full structure (faithful passthrough) |
| Credit cost | 1 (light) / 2 (full) | 1 (full) |
The response format is the biggest difference: v2 returns Google's own structure (e.g. organic_results, ai_overview, knowledge_graph, related_questions) rather than the v1 normalized shape. Test your parsing against a real v2 response — try any query live in the playground.
Before and after
The raw endpoint path changes from /api/v1/google to /api/v2/google. With the SDKs the call itself is unchanged — upgrade to >= 0.4.0 and google.search() uses v2 automatically; just update your response parsing to Google's structure.
v1 (deprecated)
curl -X POST 'https://api.scavio.dev/api/v1/google' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"query": "best coffee grinder"}'v2 (recommended)
curl -X POST 'https://api.scavio.dev/api/v2/google' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"query": "best coffee grinder"}'New endpoints in v2
All cost 1 credit and return Google's response as-is.
| Endpoint | Python | JavaScript |
|---|---|---|
/api/v2/google | google.search() | google.search() |
/api/v2/google/ai-mode | google.ai_mode() | google.aiMode() |
/api/v2/google/maps/search | google.maps_search() | google.mapsSearch() |
/api/v2/google/maps/place | google.maps_place() | google.mapsPlace() |
/api/v2/google/maps/reviews | google.maps_reviews() | google.mapsReviews() |
/api/v2/google/shopping | google.shopping() | google.shopping() |
/api/v2/google/shopping/product | google.shopping_product() | google.shoppingProduct() |
/api/v2/google/flights | google.flights() | google.flights() |
/api/v2/google/hotels | google.hotels() | google.hotels() |
/api/v2/google/news | google.news() | google.news() |
/api/v2/google/trends | google.trends() | google.trends() |
/api/v2/google/trending | google.trending() | google.trending() |
Migration checklist
- Point Google Search calls at
/api/v2/google(SDK:google.search()/google.search()). - Upgrade the SDK to
>= 0.4.0(pip install --upgrade scavio/npm install scavio@latest). - Update response parsing to Google's structure (e.g.
organic_resultsinstead of the v1 normalized fields). - Verify everything before August 4, 2026.