Google's Custom Search JSON API shuts down on January 1, 2027. If your app or agent calls customsearch/v1 to pull Google results, it stops working on that date, and the API is already closed to new customers. The fastest drop-in replacement is a real-time search API that returns structured Google SERP JSON from a single endpoint, not Google's own recommended successor, Vertex AI Search, which is a different product built for a different job.
What is actually changing
In January 2026, Google announced the end of the Custom Search JSON API and of free full-web search on Programmable Search Engine (formerly Custom Search). The dates and limits that matter:
- January 1, 2027 the Custom Search JSON API is retired; existing customers must migrate before then.
- The API is already closed to new customers, so you cannot create a fresh key today.
- Free Programmable Search Engines are being limited to a 50-domain scope, and the search-the-entire-web option is going away.
If you built anything that treats Google as a programmatic data source, RAG grounding, an agent's web-search tool, rank tracking, competitive monitoring, this is a hard deadline, not a soft deprecation.
Why Vertex AI Search is not a drop-in
Google points migrating users to Vertex AI Search. It is rarely a like-for-like swap:
- It is built to search your own corpus (your documents, your data store), not to return live public Google results.
- Pricing starts around $2 per 1,000 queries on the basic tier and climbs with extensions, a different cost model from a simple per-query SERP API.
- It carries enterprise setup and minimums that are overkill if all you wanted was "give me Google's results as JSON."
For teams whose code just needs query in, ranked results out, Vertex AI Search means re-architecting around a product you did not ask for.
What a real drop-in looks like
The migration most developers actually want is to a search API that returns Google SERP data as structured JSON over a single HTTP call. You swap the endpoint and the response parser, keep your query logic, and you are done.
That is what Scavio does. One endpoint returns organic results with link, title, and snippet fields your existing code can map onto the old Custom Search shape, and it returns clean JSON instead of raw SERP HTML.
A minimal call:
curl -X POST https://api.scavio.dev/api/v2/google \
-H "x-api-key: YOUR_KEY" \
-H "content-type: application/json" \
-d '{"query": "best web search api"}'You get back organic_results[] with link, title, and snippet, the three fields most Custom Search integrations relied on.
How to migrate before the deadline
- Inventory your calls. Find everywhere you hit
customsearch/v1and note which response fields you consume. - Pick a replacement that returns live web results, not a private-corpus product. Confirm it covers the engines you need (Google is table stakes; you may also want Maps, News, or Shopping).
- Map the response. Point your parser at the new JSON shape; for most apps this is a few lines.
- Test on real queries and compare result quality before you cut over.
- Cut over well before January 1, 2027 so you are not migrating during an outage.
If you also pull data from Amazon, YouTube, Reddit, Walmart, or TikTok, consolidating onto one API with a single key removes the multi-integration tax at the same time. See the Google search docs or start free with 50 credits to test the swap.
FAQ
When does the Google Custom Search JSON API stop working? January 1, 2027. It is already unavailable to new customers.
Is Vertex AI Search a direct replacement? No. It searches your own data corpus and is priced and architected for enterprise use, not live public Google results.
What is the closest drop-in? A real-time SERP API that returns Google results as JSON from one endpoint, so you only change the endpoint and the response mapping.