Actions6
Overview
The node connects to the Google Search Console API to retrieve detailed search analytics data for a specified verified website property. Specifically, the Get Page Insights operation queries search performance metrics such as clicks, impressions, click-through rate (CTR), and average position for pages on the site over a selected date range.
This node is useful for SEO specialists, digital marketers, and webmasters who want to automate the extraction of search performance data from Google Search Console for reporting, analysis, or integration with other tools.
Practical examples:
- Automatically fetch top-performing pages and their search queries for the last 28 days.
- Analyze device or country-specific search traffic trends for a website.
- Export daily search analytics data for custom date ranges to a database or dashboard.
Properties
| Name | Meaning |
|---|---|
| Site URL Mode | Choose how to specify the site property: either pick from your verified sites in Google Search Console or enter the site URL manually. |
| Site URL | Select a verified site property from your Google Search Console account (shown if "Pick from My Verified Sites" mode is selected). |
| Site URL (Manual) | Enter the verified site property URL manually, e.g., https://example.com/ or sc-domain:example.com (shown if "Enter Manually" mode is selected). |
| Date Range | Select a preset date range for the query: Last 7 Days, Last 28 Days, Last 3 Months, Last 12 Months, or Custom. |
| Start Date | Specify the start date for the query when using a Custom date range. |
| End Date | Specify the end date for the query when using a Custom date range. |
| Row Limit | Maximum number of rows to return (between 1 and 25,000). Controls how many result rows are fetched from the API. |
| Search Type | The type of search to query: Web, Image, Video, or News. Determines which search results to analyze. |
| Dimensions | One or more dimensions to group the data by. Options include Date, Page, Query, Country, and Device. You can select multiple dimensions to customize the granularity of the insights returned. |
Output
The output consists of JSON objects representing rows of search analytics data matching the requested parameters. Each output item includes:
- The dimension keys you requested (e.g., page URL, query text, country code).
- Metrics for each row:
clicks: Number of clicks received.impressions: Number of times the item appeared in search results.ctr: Click-through rate (clicks divided by impressions).position: Average position in search results.
Example output JSON structure for one row might look like:
{
"page": "https://example.com/page1",
"clicks": 123,
"impressions": 4567,
"ctr": 0.027,
"position": 8.4
}
If multiple dimensions are selected, the output will include keys for each dimension accordingly.
The node does not output binary data for this operation.
Dependencies
- Requires valid authentication credentials for Google Search Console API access. This can be configured via OAuth2 or a Service Account credential in n8n.
- The node uses the official Google APIs client library internally but handles HTTP requests transparently.
- No additional environment variables are required beyond setting up the appropriate Google API credentials in n8n.
Troubleshooting
- No site selected error: If you choose "Pick from My Verified Sites" but have no verified properties or select the placeholder option, the node will throw an error. Ensure you have verified sites in your Google Search Console account and select one properly.
- Authentication failed: Errors related to invalid or missing credentials indicate that the Google API credentials are not configured correctly. Verify your OAuth2 or Service Account setup.
- Row limit exceeded: The API limits the maximum rows per request to 25,000. Setting a higher value will be capped automatically.
- Invalid date range: When using a custom date range, ensure the start date is before the end date and both are valid ISO dates.
- API quota limits: Frequent or large queries may hit Google API quotas. Consider reducing row limits or query frequency.