POST https://searchconsole.googleapis.com/webmasters/v3/sites/{siteUrl}/searchAnalytics/query with Authorization: Bearer <token>
Set type to discover in the request body (the parameter accepts 'web', 'image', 'video', 'news', 'discover', 'googleNews')
Specify valid dimensions for Discover: date, page, and country are supported; do NOT include query or device dimensions — they are not available for Discover data
Set startDate and endDate in YYYY-MM-DD format; Discover data is typically available for the past 16 months
Parse the rows array in the response — each row contains keys (dimension values) and metrics: clicks, impressions, ctr, position
Note that position is not meaningful for Discover (it is always 0 or absent); focus on clicks and impressions
Known gotchas
The query and device dimensions are NOT available when type is discover — requesting them will cause the API to return an error; valid dimensions for Discover are date, page, and country only
Discover data appears in Search Console only for properties that have received significant Discover traffic; low-traffic properties may have no Discover rows even for broad date ranges
The type field replaced the older searchType field name — while searchType may still work for backward compatibility, use type as the canonical field name per current API docs
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp