QuerySail: Google Search Console

Use this when the user asks what changed between two periods, why traffic went up or down, or which pages, queries, countries or devices gained or lost. Compares clicks, impressions, CTR and average position for one property between a current period and the previous period (default), the same weekdays a year earlier, or explicit dates. Returns both totals with absolute and percent changes, the click change split into an impressions part and a CTR part, and, with a dimension, the top gainers and losers ranked by change in clicks or impressions. Dates are Pacific Time; with no dates the current period is the last 28 finalized days. Filters and search type apply to both periods. Changes are observed differences and do not identify causes. Read-only; does not change anything in Search Console.

Use this to retrieve Google Search Console search performance (clicks, impressions, CTR, average position) for one property. With no dimensions it returns property totals. Add dimensions to break results down by date, hour, query, page, country, device or searchAppearance, and filters to narrow to specific queries, pages, countries, devices or search appearances (for example mobile traffic to pages containing '/blog/'). search_type selects web (default), image, video, news, discover or googleNews results; discover and googleNews have no queries. For what happened in the last hours or days, group by hour (data_state 'hourly', last 10 days only, preliminary). Dates are Pacific Time. If no dates are given it uses the last 28 finalized days (or yesterday and today for hourly) and reports the exact dates it used. Covers one period at a time. Rows are bounded (default 20, max 100); page through with the returned cursor. Google returns only top rows for query/page breakdowns, so results are not guaranteed to be complete, and a missing row does not mean zero. Figures are observed values and do not identify causes. Read-only; cannot request indexing or change anything in Search Console.

Use this when the user asks whether specific pages are indexed by Google, why a page is not on Google, or which canonical Google chose. Runs Search Console URL Inspection for 1 to 20 full URLs of one property and returns, per URL: whether it is on Google, the coverage state (for example 'Crawled - currently not indexed'), robots.txt and noindex blocking, the page fetch result, last crawl time and crawler, the canonical Google chose versus the one the page declares, sitemaps and referring pages that list it, and detected rich results with their issues. Results describe the version Google last indexed, not a live test. Each URL must belong to the property, given by its exact property_id. Read-only; cannot request indexing, a recrawl or change anything in Search Console.

Use this when the user asks which Google Search Console sites or properties they can access, or to find the exact property_id for a site. Returns exact property IDs (Domain properties look like 'sc-domain:example.com', URL-prefix properties like 'https://example.com/'), the permission level, and connection status. The same site is listed once even if several connected Google accounts can see it. A site name can match more than one property, for example a Domain property and a URL-prefix property. Read-only. Does not change anything in Google Search Console.

Use this when the user asks which sitemaps a site has in Search Console, whether Google read them, or whether they have errors or warnings. Lists the sitemaps submitted for one property with type, whether it is an index, pending status, last submitted and last read times, error and warning counts, and how many URLs each lists by content type. Pass sitemap_index to list the sitemaps inside a sitemap index. URL counts are listed URLs, not indexed URLs. Read-only; cannot submit, resubmit or delete sitemaps.