1. Overview
  2. Image search
Tools

Image search tools for Search Console

The Search Analytics API defaults to web search, so Google Images data only appears when a request asks for type=image. Seven of these tools ask for it; the eighth audits the images on your pages directly.

The tools

Every tool that reads a property also takes site_url, so one connection covers every property your Google account can see. Ask for list_properties to get the exact strings: sc-domain:example.com and https://example.com/ are different properties with different data.

image_keyword_overview

Queries the site appears for in Google Images, sorted by impressions, clicks or position.

Ask: “What are my top Google Images queries for the last 90 days?”

ParameterDefaultNote
days90
min_impressions50
row_limit50
order_byimpressions

image_search_quick_wins

Image queries at positions 4–15, sorted by the traffic reaching position 3 would add, using a CTR baseline for image search rather than web search.

Ask: “Which image queries are close to the top three?”

ParameterDefaultNote
days90
min_impressions500
max_position15

image_pages_overview

Pages ranked by image-search clicks or impressions. Pairs with the keyword overview to map queries back to pages.

Ask: “Which of my pages actually surface in Google Images?”

ParameterDefaultNote
days90
min_impressions100
row_limit50
order_byclicks

image_impressions_no_clicks

Query and page pairs with meaningful image impressions and almost no clicks: usually a thumbnail problem.

Ask: “Where do my images get seen but not clicked?”

ParameterDefaultNote
days90
min_impressions500
max_clicks2
row_limit50

image_content_decay

The three-window decay check on image search, with a lower click threshold than the web version because image clicks run lower.

Ask: “Which pages are losing image-search clicks three months running?”

ParameterDefaultNote
min_period3_clicks5

compare_web_vs_image

One Search Analytics request per search type, joined on the query, with an impressions ratio that shows where image search carries a large share of the demand.

Ask: “Compare web and image performance for my top queries.”

ParameterDefaultNote
days90
min_combined_impressions100
row_limit50

image_page_audit

Fetches up to five of your own pages and checks every image: alt text, filenames, width and height attributes, lazy loading on the LCP candidate, srcset, format and weight, ImageObject schema, max-image-preview, and EXIF, IPTC and XMP metadata in the files. It reads pages, not Search Console, so it takes URLs instead of a property.

Ask: “Audit the images on these two pages.”

ParameterDefaultNote
urlsrequired1–5 pages from your own site
fetch_metadatatrue
max_images_per_page121–50
max_images_reported20

A real answer

From this hosted instance, run against the author's own site. Shown as it came back; rows are trimmed only where the caption says so.

Asked: “Audit the images on the k-o.pro homepage.”
image_page_audit on the hosted instance, 13 October 2026
{
  "_meta": {
    "source": "Live fetch of the audited pages (the user's own site)",
    "tool": "image_page_audit",
    "parameters": {
      "urls": [
        "https://k-o.pro/"
      ],
      "fetch_metadata": true,
      "max_images_per_page": 6,
      "max_images_reported": 6
    },
    "note": "All findings come from fetching and parsing the listed pages and image files at call time. Alt text, attributes, bytes, and dimensions are read values, not estimates. Base your analysis only on this data. An empty alt (alt=\"\") is correct for decorative images; do not report it as a defect."
  },
  "data": {
    "audits": [
      {
        "url": "https://k-o.pro/",
        "status": "ok",
        "http_status": 200,
        "page_checks": {
          "total_img_tags": 17,
          "content_images": 0,
          "images_fetched": 0,
          "lcp_candidate_src": null,
          "lcp_candidate_lazy_loaded": null,
          "lcp_candidate_fetchpriority": null,
          "inline_background_images": 0,
          "max_image_preview": "not_set",
          "image_object_schema_count": 0,
          "has_licensable_fields": false,
          "has_primary_image_of_page": false,
          "images_with_srcset": 0,
          "modern_format_sources": false
        },
        "images": [],
        "images_not_reported": 0,
        "issue_counts": {},
        "top_fixes": [
          "Add ImageObject schema (with about/mainEntity) for the page's key images",
          "Add max-image-preview:large to the robots meta for full-size previews"
        ]
      }
    ],
    "overall": {
      "pages_audited": 1,
      "pages_failed": 0,
      "total_issues": 0,
      "note": "empty alt (alt=\"\") is correct for decorative images; it is reported but not counted as an issue."
    }
  }
}

Of the 17 img tags, none counted as a content image, so no image files were fetched. The two page-level fixes it returned are about previews and schema rather than the images themselves.

Connect it

Add https://gsc.k-o.pro/mcp to claude.ai or Claude Desktop or to Claude Code, sign in with Google, and ask any of the questions above.

About this page

Version 3.8.0 · page updated 13 October 2026 · changelog

Related