Google Search Console icon

Google Search Console

Get stuff from google search console

Overview

This n8n node integrates with Google Search Console to retrieve data, specifically using the "Search Analytics" resource. It allows users to query search analytics data for a specified website and date range. This is useful for automating SEO reporting, monitoring site performance in Google Search, or integrating search analytics into broader data workflows.

Example scenarios:

  • Automatically pulling daily or weekly search analytics data for reporting.
  • Integrating Google Search Console data with other marketing or analytics tools.
  • Monitoring changes in site performance over time.

Properties

Name Type Meaning
Authentication options Selects the authentication method: Service Account or OAuth2.

Additional properties used by this Resource/Operation (from static analysis):

Name Type Meaning
Resource options The type of Google Search Console resource to interact with (e.g., Search Analytic, Sitemap).
Operation options The action to perform on the selected resource (e.g., Post for Search Analytics queries).
Site URL string The full URL of the site to query (e.g., https://blog.ikhuerta.com/).
Start Date string The start date for the analytics extraction (format: YYYY-MM-DD).
End Date string The end date for the analytics extraction (format: YYYY-MM-DD).

Output

The node outputs a JSON array containing the results from the Google Search Console Search Analytics API. The structure of each item in the output array will reflect the response from the API, typically including fields such as:

[
  {
    // Example fields (actual structure depends on API response)
    "keys": ["page_url"],
    "clicks": 123,
    "impressions": 456,
    "ctr": 0.27,
    "position": 3.5
  }
]
  • If the API returns binary data (not expected for this operation), it would be summarized as analytics data for the queried site and date range.

Dependencies

  • Google Search Console API access: Requires either a Service Account or OAuth2 credentials configured in n8n.
  • n8n Credentials: You must set up either:
    • googleApi (for Service Account authentication)
    • googleSearchConsoleOAuth2Api (for OAuth2 authentication)

Troubleshooting

Common issues:

  • Invalid credentials: Ensure that the correct authentication method is selected and credentials are properly configured in n8n.
  • Incorrect Site URL: The Site URL must exactly match a property verified in your Google Search Console account.
  • Date format errors: Dates must be in YYYY-MM-DD format; otherwise, the API may reject the request.
  • Insufficient permissions: The authenticated user/service account must have access to the specified site in Google Search Console.

Common error messages:

  • "User does not have permission to access the site": Check that the credentials have access to the specified Site URL.
  • "Invalid date format": Ensure Start Date and End Date are in the correct format.
  • "Authentication failed": Verify that the selected authentication method matches the credentials provided.

Links and References

Discussion