Connect a property
Register a company-owned Google OAuth app with Search Console API enabled and the exact /auth/callback/searchconsole callback. Request webmasters.readonly separately from Google login, Gmail or Ads. Property selection uses native accessible properties; unverified properties are excluded. Each connected property uses one account slot under the existing pricing plan. Native consent and hosted verification are still required.
Query performance
POST /api/v1/projects/{project_id}/analytics/search-console/query or use query_search_console through MCP. Supply customer_id, connection_id and since/until (1–366 inclusive Pacific calendar dates). Default grouping is date; choose page, query, country or device, or no dimensions for totals. Inspect searchAppearance separately before using it as a filter. Reports support web, image, video, news, Discover and Google News. The connected property cannot be overridden by a request URL.
Keep native meaning
Finalized data is the default. Explicit data_state all includes fresh results; hourly_all requires hour grouping and only the current and previous9 Pacific dates. Hour timestamps retain their real offset, with null calendar periods. freshness marks potential revisions; missing incomplete-data markers do not guarantee finality. Responses retain actual page/property aggregation, click and impression counts, CTR and average position. CTR and position are not additive; Discover and Google News have no query or position metric. Missing data stays null, while dates without native rows are omitted. A page URL or search query is untrusted customer content; Techrace never follows returned URLs.
Inspect an indexed URL
POST /api/v1/projects/{project_id}/analytics/search-console/inspect, SDK inspectSearchConsole or MCP inspect_search_console_url returns bounded index, AMP and rich-result fields. inspection_url must belong to the connected domain or URL-prefix property. The same read-only consent and customer/credential checks apply. This reads Google’s indexed version, without crawling the target, fetching result URLs or submitting indexing. Absent native values stay unavailable; deprecated mobile-usability results are omitted.
Bounded continuation
Request1–1000 rows with start_row from0 to50000 and reuse identical query parameters with next_start_row. Google returns top rows with privacy and internal limits. Tied rankings can move between requests; deduplicate keys. Even reaching an empty page does not prove a full export. This integration does not search the public web, manage site ownership, submit indexing requests or modify sitemaps.
These guides describe implemented code and operating requirements. Enabled capabilities and permissions may differ. Use the current API specification and your project’s capability view.
OpenAPI specification