Actions3
Overview
This node operation "Get Page Insights" connects to the Google Search Console API to retrieve detailed search analytics data for a specified verified website property. It queries metrics such as clicks, impressions, click-through rate (CTR), and average position for pages on the site over a selected date range.
Typical use cases include:
- Monitoring how specific pages perform in Google Search results.
- Analyzing trends in user queries and page visibility.
- Extracting data for SEO reporting or automated dashboards.
- Filtering insights by dimensions like date, page URL, or query terms.
For example, a digital marketer could use this node to pull the last 28 days of search performance data for their website’s blog pages, filtered to only include queries containing certain keywords.
Properties
| Name | Meaning |
|---|---|
| Site URL Mode | Choose how to specify the site: either pick from your verified sites ("Pick from My Verified Sites") or enter a verified site URL manually ("Enter Manually"). |
| Site URL | The verified site URL to query, selectable from your verified properties. Required if Site URL Mode is "Pick from My Verified Sites". |
| Site URL (Manual) | Enter a verified property URL manually. Supports domain properties using the format sc-domain:example.com. Required if Site URL Mode is "Enter Manually". |
| Date Range | Select a preset date range for the query: Last 7 Days, Last 28 Days, Last 3 Months, Last 12 Months, or Custom (to specify exact start and end dates). |
| Start Date | The start date for the custom date range. Only shown if Date Range is set to Custom. |
| End Date | The end date for the custom date range. Only shown if Date Range is set to Custom. |
| Row Limit | Maximum number of rows to return (between 1 and 25,000). Controls the volume of data retrieved. |
| Search Type | The type of search to filter by: Web, Image, Video, or News. Defaults to Web. |
| Dimensions | One or more dimensions to group the data by. Options are Date, Page, and Query. Defaults to Page. |
| Filters | Optional filters to narrow down results based on dimension values. You can add multiple filter groups, each with conditions on Query or Page dimensions using operators like Equals, Contains, Regex, etc. Groups are ANDed. |
Output
The output is an array of JSON objects, each representing a row of search analytics data matching the query parameters. Each object contains:
- Keys corresponding to the selected dimensions (e.g.,
date,page,query). - Metrics fields:
clicks: Number of clicks received.impressions: Number of times the item appeared in search results.ctr: Click-through rate (ratio of clicks to impressions).position: Average position in search results.
Example output JSON snippet:
{
"page": "https://example.com/blog/post1",
"clicks": 123,
"impressions": 4567,
"ctr": 0.027,
"position": 8.4
}
No binary data output is produced by this operation.
Dependencies
- Requires a valid OAuth2 API authentication credential configured for Google Search Console access.
- The Google Search Console API must be enabled and accessible with appropriate permissions.
- The user must have verified ownership of the site property in Google Search Console.
Troubleshooting
Error: No site selected
Occurs if no valid site URL is provided or the site URL does not start withhttp(s)://orsc-domain:.
Resolution: Ensure you select or enter a verified site URL in the correct format.Error: Failed to load sites
Happens when loading verified sites fails due to invalid credentials or insufficient permissions.
Resolution: Check that the OAuth2 credentials are correctly set up and have the required scopes.Empty results or missing data
Could be caused by incorrect date ranges, filters that exclude all data, or querying unverified sites.
Resolution: Verify date range settings, remove or adjust filters, and confirm site verification status.Row limit exceeded
The API limits maximum rows per request to 25,000. Setting a higher value will be capped automatically.
Resolution: Adjust the row limit within allowed bounds.