{"slug":"google-custom-search-json-api","name":"Google Custom Search JSON API","host":"customsearch.googleapis.com","site":"https://googleapis.com","category":"cloud","docsUrl":null,"sources":[{"kind":"discovery","url":"https://customsearch.googleapis.com/$discovery/rest?version=v1"},{"kind":"archive","url":"https://developers.google.com/custom-search/v1/overview"},{"kind":"archive","url":"https://developers.google.com/custom-search/v1/site_restricted_api"}],"url":"https://www.okapi.bot/providers/google-custom-search-json-api/","json":"https://www.okapi.bot/api/v1/providers/google-custom-search-json-api.json","breakingChanges":[{"slug":"customsearch-v1-stops-working","api":"google-custom-search-json-api","title":"/customsearch/v1* stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2027-01-01","scope":null,"calls":["GET /customsearch/v1*"],"method":"GET","path":"/customsearch/v1*","source":{"url":"https://developers.google.com/custom-search/v1/overview","kind":"archive"},"quote":"Existing Custom Search JSON API customers have until January 1, 2027 to transition to an alternative solution.","migration":"Move to Vertex AI Search (up to 50 domains), or contact Google about its full web search solution.","migrationChange":null,"needsDecision":"Vertex AI Search is another Google Cloud product, with its own setup and pricing.","text":{"summary":"On January 1, 2027, the Google Custom Search JSON API will shut down GET /customsearch/v1* calls. Requests sent to customsearch.googleapis.com using these endpoints will fail after that day. Existing customers have until this date to transition to an alternative solution.","migration":"Move to Vertex AI Search for up to 50 domains, or contact Google about its full web search solution. Transitioning requires more than updating an identifier, as Vertex AI Search is a separate Google Cloud product with its own setup and pricing.","by":"writer"},"publishedAt":"2026-10-23T10:24:11.091Z","updatedAt":"2026-10-23T12:52:41.846Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/google-custom-search-json-api/breaking-changes/customsearch-v1-stops-working/"},{"slug":"get-customsearch-v1-siterestrict-stops-working","api":"google-custom-search-json-api","title":"GET /customsearch/v1/siterestrict stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2025-01-08","scope":null,"calls":["GET /customsearch/v1/siterestrict"],"method":"GET","path":"/customsearch/v1/siterestrict","source":{"url":"https://developers.google.com/custom-search/v1/site_restricted_api","kind":"archive"},"quote":"The Custom Search Site Restricted JSON API will cease to serve traffic on January 8, 2025, requiring customers to transition to Google Cloud's Vertex AI Search.","migration":"Move the site-restricted search to Vertex AI Search on Google Cloud.","migrationChange":null,"needsDecision":"Vertex AI Search is another Google Cloud product, with its own setup and pricing.","text":null,"publishedAt":"2026-10-23T10:24:09.084Z","updatedAt":"2026-10-23T10:24:09.084Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/google-custom-search-json-api/breaking-changes/get-customsearch-v1-siterestrict-stops-working/"}]}