SearchAnalyticsQueryRequest

Request body for querying search analytics data. Defines the date range, dimensions, filters, and aggregation type for the query.

AnalyticsGoogleSearchSEOWebmaster Tools

Properties

Name Type Description
startDate string Start date of the requested date range, in YYYY-MM-DD format. Must be less than or equal to the end date. Data is available starting from the date the site was added to Search Console.
endDate string End date of the requested date range, in YYYY-MM-DD format. Must be greater than or equal to the start date. There is a processing delay of approximately 2-3 days.
dimensions array Zero or more dimensions to group results by. Results are grouped in the order that dimensions are specified. Valid dimensions are date, query, page, country, device, and searchAppearance.
type string Filter results to the specified search type. Defaults to web.
dimensionFilterGroups array Zero or more groups of dimension filters. All filter groups are ANDed together. Within a group, filters are combined using the group type (AND by default).
aggregationType string How data is aggregated. If auto, data is aggregated by property type. If byPage, all data is aggregated by page. If byProperty, all data is aggregated by property.
rowLimit integer Maximum number of rows to return. Valid range is 1 to 25000. Default is 1000.
startRow integer Zero-based index of the first row in the response. Must be a non-negative number. Default is 0.
dataState string The data state to filter on. If set to final, only finalized data is returned. If set to all, both finalized and fresh data are included.
View JSON Schema on GitHub