Google Search Console

Interact with Google Search Console API for SEO data management

Actions5

Overview

This node integrates with the Google Search Console API to manage and retrieve SEO-related data for verified websites. Specifically, the "Get Sitemap Details" operation fetches detailed information about a particular sitemap associated with a verified site. This is useful for SEO specialists or webmasters who want to monitor the status, coverage, and metadata of their submitted sitemaps directly within an automated workflow.

Practical examples include:

Verifying that a sitemap has been correctly processed by Google.
Checking the number of URLs indexed from a sitemap.
Diagnosing issues related to sitemap submission or indexing.

Properties

Name	Meaning
Site URL	The URL of the verified website in Google Search Console (e.g., `https://example.com/`).
Sitemap URL	The full URL of the sitemap file you want to get details for (e.g., `https://example.com/sitemap.xml`).

Output

The output JSON contains detailed information about the specified sitemap as returned by the Google Search Console API. This typically includes metadata such as:

Sitemap path and type.
Last downloaded timestamp.
Number of discovered URLs.
Warnings or errors related to the sitemap.
Indexing status and coverage details.

The exact structure depends on the API response but generally provides comprehensive insight into the sitemap's processing status.

No binary data output is produced by this operation.

Dependencies

Requires a valid Google API authentication credential with access to Google Search Console.
The node uses Google’s official googleapis library to interact with the Search Console API.
Necessary OAuth2 credentials must be configured in n8n to authenticate requests.

Troubleshooting

Common Issues:
- Invalid or unverified Site URL: The site must be verified in Google Search Console; otherwise, the API will reject requests.
- Incorrect Sitemap URL: Ensure the sitemap URL is correct and accessible.
- Insufficient permissions: The API credential must have appropriate scopes enabled.
Error Messages:
- "The operation "getSitemap" is not supported!": Indicates an unsupported operation was requested; ensure the operation parameter is set correctly.
- API errors related to authorization or quota limits: Check API key validity and usage limits.
Resolution Tips:
- Verify site ownership in Google Search Console.
- Double-check URLs for typos.
- Confirm that the API credentials have the required scopes (webmasters.readonly and webmasters).
- Enable "Continue On Fail" in the node settings to handle partial failures gracefully.