You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Google Search Console – Site Performance (Analytics) Action
1
+
# Google Search Console – Site Performance (Analytics) Action
2
2
3
3
This action queries **search performance data** for a verified website using the [Google Search Console API](https://developers.google.com/webmaster-tools/search-console-api-original/v3/searchanalytics/query). It allows you to extract insights like:
4
4
@@ -9,15 +9,15 @@ This action queries **search performance data** for a verified website using the
9
9
10
10
---
11
11
12
-
## Use Cases
12
+
## Use Cases
13
13
14
14
- Automate SEO reporting
15
15
- Analyze organic search trends
16
16
- Filter and break down traffic by dimensions (e.g. query, device, country)
17
17
18
18
---
19
19
20
-
## Internals
20
+
## Internals
21
21
22
22
- Supports all relevant props from the [Search Analytics Query API](https://developers.google.com/webmaster-tools/search-console-api-original/v3/searchanalytics/query)
23
23
- Trims and validates all input props
@@ -28,83 +28,81 @@ This action queries **search performance data** for a verified website using the
28
28
29
29
---
30
30
31
-
## Auth
31
+
## Auth
32
32
33
-
Requires OAuth 2.0 with the following scope: https://www.googleapis.com/auth/webmasters.readonly
33
+
Requires OAuth 2.0 with the following scope: `https://www.googleapis.com/auth/webmasters.readonly`
// Optional: Skips the first N rows — used for pagination.
69
59
"startRow": 0,
70
60
71
-
// Optional: How to group data.
72
-
// "auto" = Google's default grouping.
73
-
// "byPage" = Group by page (useful for getting per-page breakdowns).
74
61
"aggregationType": "auto",
75
62
76
-
// Optional: Data freshness filter.
77
-
// "final" = Only finalized data (more accurate).
78
-
// "all" = Includes fresh but possibly incomplete data.
79
63
"dataState": "final",
80
64
81
-
// Optional filter group(s) to restrict which rows are returned.
82
-
// Each group applies logical AND/OR across its filters.
83
65
"dimensionFilterGroups": [
84
66
{
85
-
// Logical grouping operator for the filters inside this group.
86
-
// "and" = all filters must match
87
-
// "or" = any filter can match
67
+
88
68
"groupType": "and",
89
69
90
-
// List of individual filters to apply within the group
91
70
"filters": [
92
71
{
93
-
// Which dimension to filter by (must match a dimension in your request)
72
+
94
73
"dimension": "query",
95
74
96
-
// Filter operator — e.g., "equals", "contains", "notEquals", etc.
97
75
"operator": "contains",
98
76
99
-
// Value to match against
100
77
"expression": "example"
101
78
},
102
79
{
103
80
"dimension": "country",
81
+
104
82
"operator": "equals",
83
+
105
84
"expression": "USA"
106
85
}
107
86
]
108
87
}
109
88
]
110
-
}
89
+
}
90
+
```
91
+
92
+
### Field Descriptions
93
+
94
+
**siteUrl**: The site you want to query data for. Must be verified in your Google Search Console account.
95
+
**startDate**: The start date of the reporting period (inclusive), in YYYY-MM-DD format.
96
+
**endDate**: The end date of the reporting period (inclusive), in YYYY-MM-DD format.
97
+
**dimensions**: The dimensions you want to break down the data by. Valid values: "query", "page", "country", "device", "searchAppearance", "date". Order matters — it affects how rows are grouped in the response.
98
+
**searchType**: The type of search data to include. Valid values: "web", "image", "video", "news", "googleNews", "discover"
99
+
**rowLimit**: Maximum number of rows to return (1–25,000)
100
+
**startRow**: Optional: Skips the first N rows — used for pagination.
101
+
**aggregationType**: Optional: How to group data. "auto" = Google's default grouping. "byPage" = Group by page (useful for getting per-page breakdowns).
102
+
**dataState**: Optional: Data freshness filter. "final" = Only finalized data (more accurate). "all" = Includes fresh but possibly incomplete data.
103
+
**dimensionFilterGroups**: Optional filter group(s) to restrict which rows are returned. Each group applies logical AND/OR across its filters.
104
+
**groupType**: Logical grouping operator for the filters inside this group. "and" = all filters must match, "or" = any filter can match
105
+
**filters**: List of individual filters to apply within the group
106
+
**dimension**: Which dimension to filter by (must match a dimension in your request)
107
+
**operator**: Filter operator — e.g., "equals", "contains", "notEquals", etc.
Copy file name to clipboardExpand all lines: components/google_search_console/actions/retrieve-site-performance-data/retrieve-site-performance-data.mjs
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -180,12 +180,12 @@ export default {
180
180
// Identify if the error was thrown by internal validation or by the API call
0 commit comments