The Google Search Console APIs manage a Wix site's presence in Google Search Console: from connecting a Google account, through verifying the site and submitting its sitemap, to reading inspection results and search performance data.
The Google Search Console APIs include:
- GSC Connection: Connect a Wix site to Google Search Console by linking a Google account. Wix runs the authorization in the browser and stores the credentials server-side, so the connection is established without handling tokens.
- GSC Site Readiness: Act on Google Search Console through the connected account. Verify the site, add it as a Search Console property, submit its sitemap, request indexing, inspect pages, and read search performance data.
The two APIs compose in order: connect first with the GSC Connection API, then run the setup and reporting methods of the GSC Site Readiness API. Methods that reach Google Search Console fail with a MISSING_TOKEN error until the site is connected.
It's important to note the following points before starting to code:
- The site must be published, have a connected domain, and allow search-engine indexing. The connection flow and the setup methods that write to Google Search Console fail with
FAILED_PRECONDITION until the site is ready.
- Calls that reach Google are subject to the property's Google API quotas, and Google-side failures surface as retryable errors:
GOOGLE_QUOTA_EXCEEDED after the quota window resets, and GOOGLE_UNAVAILABLE with backoff.
- Connection: The link between a Wix site and a Google account, held as Google credentials that Wix stores server-side and never returns.
- Search Console property: The representation of the site in Google Search Console. The GSC Site Readiness API's Add Site creates it in the connected account.
- Site readiness: The site's standing in Google Search Console setup:
READY when setup is complete, or NOT_READY with the first blocking step.
- URL inspection: Google's per-page report of index status and issues.