{
  "data": {
    "id": "Ww3tOPFAfnPOyS3SW",
    "actId": "I4Ag5MADZDiXkhJn9",
    "userId": "tnBVjt3CXmcUrEE3L",
    "startedAt": "2026-11-19T01:56:20.091Z",
    "finishedAt": "2026-11-19T01:57:02.335Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CI"
    },
    "stats": {
      "durationMillis": 42168,
      "runTimeSecs": 42.168,
      "computeUnits": 0.04685333333333333,
      "imageSizeBytes": 3224545792
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "F2Aeb3gE2syjqz9xC",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Google Lens Visual Match & Reverse Image Search\",\n  \"description\": \"Search Google Lens from public image URLs or images stored in the run's key-value store. Choose the All, Visual matches, Exact matches, Products or OCR result set.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"sectionCaption\": \"What to collect\",\n      \"title\": \"Result set\",\n      \"type\": \"string\",\n      \"description\": \"All returns visual matches with product offers, Google's AI description and follow-up searches. Visual matches returns similar pages and images. Exact matches returns pages carrying the same image. Products returns only matches with a price. OCR only reads text from the image.\",\n      \"editor\": \"select\",\n      \"default\": \"all\",\n      \"prefill\": \"all\",\n      \"enum\": [\n        \"all\",\n        \"visualMatches\",\n        \"exactMatches\",\n        \"products\",\n        \"ocr\"\n      ],\n      \"enumTitles\": [\n        \"All results\",\n        \"Visual matches\",\n        \"Exact matches\",\n        \"Products (priced matches)\",\n        \"OCR only\"\n      ]\n    },\n    \"imageUrls\": {\n      \"sectionCaption\": \"Images\",\n      \"title\": \"Image URLs\",\n      \"type\": \"array\",\n      \"description\": \"Public direct image URLs (JPEG, PNG, WebP, GIF, AVIF). A web page URL is not an image URL. Add one or more images in the order you want them searched.\",\n      \"editor\": \"stringList\",\n      \"prefill\": [\n        \"https://images.unsplash.com/photo-1502602898657-3e91760cbb34?w=640\"\n      ],\n      \"items\": {\n        \"type\": \"string\"\n      }\n    },\n    \"imageKeys\": {\n      \"title\": \"Key-value store image keys\",\n      \"type\": \"array\",\n      \"description\": \"Optional. Keys in this run's key-value store that hold image files. Use this instead of image URLs when the pictures are already in Apify storage.\",\n      \"editor\": \"stringList\",\n      \"items\": {\n        \"type\": \"string\"\n      }\n    },\n    \"country\": {\n      \"sectionCaption\": \"Market and language\",\n      \"title\": \"Country\",\n      \"type\": \"string\",\n      \"description\": \"Country whose Google market is used for results, prices and the shopping offers.\",\n      \"editor\": \"select\",\n      \"default\": \"US\",\n      \"prefill\": \"US\",\n      \"enum\": [\n        \"US\",\n        \"GB\",\n        \"CA\",\n        \"AU\",\n        \"NZ\",\n        \"IE\",\n        \"DE\",\n        \"FR\",\n        \"ES\",\n        \"IT\",\n        \"NL\",\n        \"BE\",\n        \"CH\",\n        \"AT\",\n        \"SE\",\n        \"NO\",\n        \"DK\",\n        \"FI\",\n        \"PL\",\n        \"PT\",\n        \"GR\",\n        \"CZ\",\n        \"RO\",\n        \"HU\",\n        \"TR\",\n        \"RU\",\n        \"UA\",\n        \"IN\",\n        \"PK\",\n        \"BD\",\n        \"LK\",\n        \"NP\",\n        \"AE\",\n        \"SA\",\n        \"QA\",\n        \"KW\",\n        \"IL\",\n        \"EG\",\n        \"ZA\",\n        \"NG\",\n        \"KE\",\n        \"BR\",\n        \"MX\",\n        \"AR\",\n        \"CL\",\n        \"CO\",\n        \"PE\",\n        \"JP\",\n        \"KR\",\n        \"CN\",\n        \"HK\",\n        \"TW\",\n        \"SG\",\n        \"MY\",\n        \"ID\",\n        \"TH\",\n        \"VN\",\n        \"PH\"\n      ],\n      \"enumTitles\": [\n        \"United States\",\n        \"United Kingdom\",\n        \"Canada\",\n        \"Australia\",\n        \"New Zealand\",\n        \"Ireland\",\n        \"Germany\",\n        \"France\",\n        \"Spain\",\n        \"Italy\",\n        \"Netherlands\",\n        \"Belgium\",\n        \"Switzerland\",\n        \"Austria\",\n        \"Sweden\",\n        \"Norway\",\n        \"Denmark\",\n        \"Finland\",\n        \"Poland\",\n        \"Portugal\",\n        \"Greece\",\n        \"Czechia\",\n        \"Romania\",\n        \"Hungary\",\n        \"Turkey\",\n        \"Russia\",\n        \"Ukraine\",\n        \"India\",\n        \"Pakistan\",\n        \"Bangladesh\",\n        \"Sri Lanka\",\n        \"Nepal\",\n        \"United Arab Emirates\",\n        \"Saudi Arabia\",\n        \"Qatar\",\n        \"Kuwait\",\n        \"Israel\",\n        \"Egypt\",\n        \"South Africa\",\n        \"Nigeria\",\n        \"Kenya\",\n        \"Brazil\",\n        \"Mexico\",\n        \"Argentina\",\n        \"Chile\",\n        \"Colombia\",\n        \"Peru\",\n        \"Japan\",\n        \"South Korea\",\n        \"China\",\n        \"Hong Kong\",\n        \"Taiwan\",\n        \"Singapore\",\n        \"Malaysia\",\n        \"Indonesia\",\n        \"Thailand\",\n        \"Vietnam\",\n        \"Philippines\"\n      ]\n    },\n    \"language\": {\n      \"title\": \"Language\",\n      \"type\": \"string\",\n      \"description\": \"Interface and result language. Match coverage can differ between languages; English returns the widest coverage.\",\n      \"editor\": \"select\",\n      \"default\": \"en\",\n      \"prefill\": \"en\",\n      \"enum\": [\n        \"en\",\n        \"de\",\n        \"fr\",\n        \"es\",\n        \"it\",\n        \"pt\",\n        \"nl\",\n        \"sv\",\n        \"no\",\n        \"da\",\n        \"fi\",\n        \"pl\",\n        \"cs\",\n        \"ro\",\n        \"hu\",\n        \"el\",\n        \"tr\",\n        \"ru\",\n        \"uk\",\n        \"hi\",\n        \"ur\",\n        \"bn\",\n        \"ta\",\n        \"te\",\n        \"mr\",\n        \"ar\",\n        \"he\",\n        \"fa\",\n        \"id\",\n        \"ms\",\n        \"th\",\n        \"vi\",\n        \"ja\",\n        \"ko\",\n        \"zh\"\n      ],\n      \"enumTitles\": [\n        \"English\",\n        \"German\",\n        \"French\",\n        \"Spanish\",\n        \"Italian\",\n        \"Portuguese\",\n        \"Dutch\",\n        \"Swedish\",\n        \"Norwegian\",\n        \"Danish\",\n        \"Finnish\",\n        \"Polish\",\n        \"Czech\",\n        \"Romanian\",\n        \"Hungarian\",\n        \"Greek\",\n        \"Turkish\",\n        \"Russian\",\n        \"Ukrainian\",\n        \"Hindi\",\n        \"Urdu\",\n        \"Bengali\",\n        \"Tamil\",\n        \"Telugu\",\n        \"Marathi\",\n        \"Arabic\",\n        \"Hebrew\",\n        \"Persian\",\n        \"Indonesian\",\n        \"Malay\",\n        \"Thai\",\n        \"Vietnamese\",\n        \"Japanese\",\n        \"Korean\",\n        \"Chinese\"\n      ]\n    },\n    \"maxItems\": {\n      \"sectionCaption\": \"Output\",\n      \"title\": \"Maximum matches per image\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum match rows saved for each image. One Lens lookup returns up to about 60 visual matches and up to 400 exact matches, so larger values do not create more source results.\",\n      \"default\": 100,\n      \"prefill\": 3,\n      \"minimum\": 1,\n      \"maximum\": 1000\n    },\n    \"includeOcr\": {\n      \"title\": \"Include OCR text\",\n      \"type\": \"boolean\",\n      \"description\": \"Also read text from each image with Google Lens OCR. The text, language and paragraph boxes are added to the image summary. Adds about one second per image.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"rehostImages\": {\n      \"title\": \"Rehost blocked match images\",\n      \"type\": \"boolean\",\n      \"description\": \"Check each full-size match image and copy images whose host blocks hotlinking into this run's key-value store, returning a public URL and keeping the source URL in imageUrlOriginal. Thumbnails and exact-match previews are already public or rehosted. Turn this off to save storage when you only need the source URLs.\",\n      \"default\": true,\n      \"prefill\": true\n    }\n  },\n  \"required\": []\n}",
    "readme": "# Google Lens Visual Match & Reverse Image Search\n\nSearch any picture with Google Lens and get the web pages, images and product offers behind it. Send public image URLs or images from the run's key-value store, pick the result set you need, and receive flat rows with page links, thumbnails, full-size image URLs, dimensions, prices, ratings and stock labels.\n\n## What you get\n\nFor every image the actor saves:\n\n- **Visual matches** — visually similar pages and images, in Google's order, with position, title, source site, domain, page URL, thumbnail, full-size image URL and pixel dimensions.\n- **Product offers** — price as shown plus parsed amount and currency, merchant, rating, review count and stock label for matches that are shoppable listings.\n- **Exact matches** — the pages carrying the same image, with title, source, publication date where Google shows one, the source image's pixel dimensions, a thumbnail and the resolved destination URL.\n- **Google's AI description** — the text Google's Lens result page writes about the image.\n- **Detected entity** — the subject name parsed from Google's own description, with the full description beside it.\n- **Related searches** — the follow-up questions Google suggests for the image, when the result page shows them.\n- **Detected objects** — the regions Lens found in the picture (whole image, main subject, objects, text blocks) with normalized boxes.\n- **OCR text** (optional) — the text read from the image, its language, and paragraphs with normalized boxes.\n- **Image summary** — one row per image with counts, status, warnings and the original image's dimensions.\n\n## Input\n\n| Field | Type | Description | Default |\n|---|---|---|---|\n| `mode` | select | `all`, `visualMatches`, `exactMatches`, `products` or `ocr`. | `all` |\n| `imageUrls` | array | Public direct image URLs. One or many. | |\n| `imageKeys` | array | Optional. Keys in this run's key-value store that hold image files. | |\n| `country` | select | Google market used for results and prices. | `US` |\n| `language` | select | Result language. | `en` |\n| `maxItems` | integer | Maximum match rows per image (1–1000). | `100` |\n| `includeOcr` | boolean | Add OCR text to the image summary for any mode. | `false` |\n| `rehostImages` | boolean | Copy full-size match images whose host blocks hotlinking into this run's key-value store and return a public URL, keeping the source URL in `imageUrlOriginal`. | `true` |\n\nExample:\n\n```json\n{\n  \"mode\": \"all\",\n  \"imageUrls\": [\n    \"https://images.unsplash.com/photo-1502602898657-3e91760cbb34?w=640\"\n  ],\n  \"country\": \"US\",\n  \"language\": \"en\",\n  \"maxItems\": 50,\n  \"includeOcr\": false\n}\n```\n\n## Output\n\nEach dataset row is a match or an image summary.\n\n```json\n{\n  \"recordType\": \"match\",\n  \"matchType\": \"visual\",\n  \"position\": 1,\n  \"inputImageUrl\": \"https://example.com/photo.jpg\",\n  \"title\": \"A guide to flying to France | Documents, Distance, Airports\",\n  \"source\": \"Sherburn Aero Club\",\n  \"domain\": \"sherburnaeroclub.com\",\n  \"pageUrl\": \"https://sherburnaeroclub.com/blog/a-guide-to-flying-to-france\",\n  \"thumbnailUrl\": \"https://encrypted-tbn0.gstatic.com/images?q=tbn:...\",\n  \"imageUrl\": \"https://sherburnaeroclub.com/storage/medialibrary/flying-to-france.jpg\",\n  \"imageWidth\": 3530,\n  \"imageHeight\": 5309,\n  \"searchCountry\": \"US\",\n  \"searchLanguage\": \"en\",\n  \"scrapedAt\": \"2026-11-15T00:00:00+00:00\"\n}\n```\n\nProduct matches add `price`, `currency`, `currencyCode`, `priceText`, `merchant`, `rating`, `reviewCount` and `inStock`. Exact matches add `date`, `googleRedirectUrl` and the source image dimensions. When a full-size match image had to be copied into storage, `imageUrlOriginal` keeps the source URL. The image summary row adds `aiOverview`, `knowledgeEntity`, `relatedSearches`, `detectedObjects`, `ocr`, `counts` and `status`.\n\n## Modes\n\n| Mode | What it returns |\n|---|---|\n| `all` | Visual matches, product offers, AI description, entity, related searches and detected objects. |\n| `visualMatches` | Visual matches and product offers only. Faster than `all`. |\n| `exactMatches` | Pages carrying the same image, up to Google's 400-row source ceiling. |\n| `products` | Only visual matches that carry a price. |\n| `ocr` | Only OCR text, language and paragraph boxes. No browser session needed. |\n\nAdd `includeOcr: true` to any non-OCR mode to attach OCR to the image summary.\n\n## Use cases\n\n- Find where a photo appears on the web and who published it.\n- Check whether your product photography is being reused by other sellers.\n- Turn a product photo into a list of similar listings with prices and stock.\n- Read text from screenshots, signs, labels and documents without a separate OCR tool.\n- Enrich a catalogue with visually similar pages and the entity Google recognizes.\n- Feed an AI agent structured visual-search results instead of raw HTML.\n\n## How it works\n\nThe actor prepares each image the same way Google's own upload widget does, sends it to Google Lens, and reads the result page's embedded match map plus its visible cards. Exact-match destination links are resolved from Google's redirect wrapper without visiting the merchant site. OCR uses Google's Chromium Lens endpoint. No Google account, cookie or API key is required.\n\n## Limitations\n\n- **Visual matches are capped by Google.** One lookup returns about 60 visual matches. A larger `maxItems` does not create more source results.\n- **Exact matches are capped at 400 and can be empty.** Google returns an exact set for some images and nothing for others; the same image can change between lookups.\n- **The separate Products tab was retired by Google in October 2026.** Product offers now arrive inside visual matches, so `products` filters price-bearing visual matches instead of opening a Products tab.\n- **Product fields are shown only when the retailer publishes them.** Price, rating, review count and stock are omitted when Google does not display them.\n- **A separate Knowledge Graph entity card is no longer shown.** The actor returns Google's AI description and derives the subject name from that description; when no name can be parsed, only the description is returned.\n- **Related searches appear as AI follow-up questions when Google shows them.** The current Lens page does not always include them.\n- **Image URLs must be public and direct.** Login-protected links, private hosts and web pages that merely contain an image are rejected.\n- **Full-size match images belong to their source sites.** Thumbnails are Google-hosted and always public. With `rehostImages` on (the default), images whose host blocks hotlinking are copied into the run's key-value store and returned as public URLs; `imageUrlOriginal` keeps the source link. An image that cannot be fetched at all is omitted rather than replaced by a broken link.\n- **Google sometimes asks for a captcha.** The actor retries with new sessions and connections; if Google refuses every attempt, the image summary says so and no match rows are saved for that image.\n- **OCR is a best-effort read.** Stylized text, very small type and low-contrast images may produce little or no text.\n\n## FAQ\n\n**Do I need a Google account or API key?** No.\n\n**Can I search an image stored on my computer?** Yes. Put the file in the run's key-value store and pass its key in `imageKeys`.\n\n**Why did an exact-match lookup return nothing?** Google does not have an exact set for every image, and the set changes over time. Try the same image later or use `visualMatches`.\n\n**Why are some product fields missing?** Google only shows a price, rating, review count or stock label when the listing publishes it.\n\n**Can I get more than 60 visual matches?** No. That is Google's source ceiling, not an actor setting.\n\n**What does `status` mean on the image summary?** `ok` means the result set was collected. `partial` means a secondary part (for example the AI description or exact tab) was unavailable. `blocked` means Google refused the Lens page for every connection. `error` means the image itself could not be loaded.\n\n**Are thumbnails and full-size image URLs usable outside Apify?** Thumbnails are public Google-hosted images. Full-size URLs point at the source site and may be protected by that site.\n\n## Data source\n\nResults come from public Google Lens pages. This actor is independent and is not affiliated with, endorsed by, or sponsored by Google LLC. Google Lens is a trademark of Google LLC.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "google-lens-scraper",
      "title": "Google Lens Visual Match and Reverse Image Search",
      "description": "Search Google Lens with image URLs or key-value store images and get visual matches, exact matches, product offers, detected entities, related searches and OCR text with page links, thumbnails, dimensions and prices.",
      "version": "1.0",
      "buildTag": "latest",
      "meta": {
        "templateId": "python-playwright"
      },
      "defaultMemoryMbytes": 2048,
      "minMemoryMbytes": 1024,
      "input": {
        "title": "Google Lens Visual Match & Reverse Image Search",
        "description": "Search Google Lens from public image URLs or images stored in the run's key-value store. Choose the All, Visual matches, Exact matches, Products or OCR result set.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "sectionCaption": "What to collect",
            "title": "Result set",
            "type": "string",
            "description": "All returns visual matches with product offers, Google's AI description and follow-up searches. Visual matches returns similar pages and images. Exact matches returns pages carrying the same image. Products returns only matches with a price. OCR only reads text from the image.",
            "editor": "select",
            "default": "all",
            "prefill": "all",
            "enum": [
              "all",
              "visualMatches",
              "exactMatches",
              "products",
              "ocr"
            ],
            "enumTitles": [
              "All results",
              "Visual matches",
              "Exact matches",
              "Products (priced matches)",
              "OCR only"
            ]
          },
          "imageUrls": {
            "sectionCaption": "Images",
            "title": "Image URLs",
            "type": "array",
            "description": "Public direct image URLs (JPEG, PNG, WebP, GIF, AVIF). A web page URL is not an image URL. Add one or more images in the order you want them searched.",
            "editor": "stringList",
            "prefill": [
              "https://images.unsplash.com/photo-1502602898657-3e91760cbb34?w=640"
            ],
            "items": {
              "type": "string"
            }
          },
          "imageKeys": {
            "title": "Key-value store image keys",
            "type": "array",
            "description": "Optional. Keys in this run's key-value store that hold image files. Use this instead of image URLs when the pictures are already in Apify storage.",
            "editor": "stringList",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "sectionCaption": "Market and language",
            "title": "Country",
            "type": "string",
            "description": "Country whose Google market is used for results, prices and the shopping offers.",
            "editor": "select",
            "default": "US",
            "prefill": "US",
            "enum": [
              "US",
              "GB",
              "CA",
              "AU",
              "NZ",
              "IE",
              "DE",
              "FR",
              "ES",
              "IT",
              "NL",
              "BE",
              "CH",
              "AT",
              "SE",
              "NO",
              "DK",
              "FI",
              "PL",
              "PT",
              "GR",
              "CZ",
              "RO",
              "HU",
              "TR",
              "RU",
              "UA",
              "IN",
              "PK",
              "BD",
              "LK",
              "NP",
              "AE",
              "SA",
              "QA",
              "KW",
              "IL",
              "EG",
              "ZA",
              "NG",
              "KE",
              "BR",
              "MX",
              "AR",
              "CL",
              "CO",
              "PE",
              "JP",
              "KR",
              "CN",
              "HK",
              "TW",
              "SG",
              "MY",
              "ID",
              "TH",
              "VN",
              "PH"
            ],
            "enumTitles": [
              "United States",
              "United Kingdom",
              "Canada",
              "Australia",
              "New Zealand",
              "Ireland",
              "Germany",
              "France",
              "Spain",
              "Italy",
              "Netherlands",
              "Belgium",
              "Switzerland",
              "Austria",
              "Sweden",
              "Norway",
              "Denmark",
              "Finland",
              "Poland",
              "Portugal",
              "Greece",
              "Czechia",
              "Romania",
              "Hungary",
              "Turkey",
              "Russia",
              "Ukraine",
              "India",
              "Pakistan",
              "Bangladesh",
              "Sri Lanka",
              "Nepal",
              "United Arab Emirates",
              "Saudi Arabia",
              "Qatar",
              "Kuwait",
              "Israel",
              "Egypt",
              "South Africa",
              "Nigeria",
              "Kenya",
              "Brazil",
              "Mexico",
              "Argentina",
              "Chile",
              "Colombia",
              "Peru",
              "Japan",
              "South Korea",
              "China",
              "Hong Kong",
              "Taiwan",
              "Singapore",
              "Malaysia",
              "Indonesia",
              "Thailand",
              "Vietnam",
              "Philippines"
            ]
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Interface and result language. Match coverage can differ between languages; English returns the widest coverage.",
            "editor": "select",
            "default": "en",
            "prefill": "en",
            "enum": [
              "en",
              "de",
              "fr",
              "es",
              "it",
              "pt",
              "nl",
              "sv",
              "no",
              "da",
              "fi",
              "pl",
              "cs",
              "ro",
              "hu",
              "el",
              "tr",
              "ru",
              "uk",
              "hi",
              "ur",
              "bn",
              "ta",
              "te",
              "mr",
              "ar",
              "he",
              "fa",
              "id",
              "ms",
              "th",
              "vi",
              "ja",
              "ko",
              "zh"
            ],
            "enumTitles": [
              "English",
              "German",
              "French",
              "Spanish",
              "Italian",
              "Portuguese",
              "Dutch",
              "Swedish",
              "Norwegian",
              "Danish",
              "Finnish",
              "Polish",
              "Czech",
              "Romanian",
              "Hungarian",
              "Greek",
              "Turkish",
              "Russian",
              "Ukrainian",
              "Hindi",
              "Urdu",
              "Bengali",
              "Tamil",
              "Telugu",
              "Marathi",
              "Arabic",
              "Hebrew",
              "Persian",
              "Indonesian",
              "Malay",
              "Thai",
              "Vietnamese",
              "Japanese",
              "Korean",
              "Chinese"
            ]
          },
          "maxItems": {
            "sectionCaption": "Output",
            "title": "Maximum matches per image",
            "type": "integer",
            "description": "Maximum match rows saved for each image. One Lens lookup returns up to about 60 visual matches and up to 400 exact matches, so larger values do not create more source results.",
            "default": 100,
            "prefill": 3,
            "minimum": 1,
            "maximum": 1000
          },
          "includeOcr": {
            "title": "Include OCR text",
            "type": "boolean",
            "description": "Also read text from each image with Google Lens OCR. The text, language and paragraph boxes are added to the image summary. Adds about one second per image.",
            "default": false,
            "prefill": false
          },
          "rehostImages": {
            "title": "Rehost blocked match images",
            "type": "boolean",
            "description": "Check each full-size match image and copy images whose host blocks hotlinking into this run's key-value store, returning a public URL and keeping the source URL in imageUrlOriginal. Thumbnails and exact-match previews are already public or rehosted. Turn this off to save storage when you only need the source URLs.",
            "default": true,
            "prefill": true
          }
        },
        "required": []
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Google Lens Visual Match & Reverse Image Search Output",
        "description": "One dataset row per visual, exact or product match, plus one image summary row per searched image with the AI description, detected entity, related searches, detected objects and optional OCR text.",
        "type": "object",
        "properties": {
          "matches": {
            "type": "string",
            "title": "Lens matches and image summaries",
            "description": "Rows with recordType=match carry position, title, source, domain, page URL, thumbnail, full image, dimensions, price, currency, rating, review count, stock and date. Rows with recordType=imageSummary carry the per-image AI description, entity, related searches, detected objects, OCR and counts.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          },
          "summary": {
            "type": "string",
            "title": "Run summary",
            "description": "Per-run tallies of images searched, matches saved, OCR images and warnings.",
            "template": "{{links.apiDefaultKeyValueStoreUrl}}/records/SUMMARY"
          }
        }
      },
      "dockerfile": "./Dockerfile",
      "readme": "# Google Lens Visual Match & Reverse Image Search\n\nSearch any picture with Google Lens and get the web pages, images and product offers behind it. Send public image URLs or images from the run's key-value store, pick the result set you need, and receive flat rows with page links, thumbnails, full-size image URLs, dimensions, prices, ratings and stock labels.\n\n## What you get\n\nFor every image the actor saves:\n\n- **Visual matches** — visually similar pages and images, in Google's order, with position, title, source site, domain, page URL, thumbnail, full-size image URL and pixel dimensions.\n- **Product offers** — price as shown plus parsed amount and currency, merchant, rating, review count and stock label for matches that are shoppable listings.\n- **Exact matches** — the pages carrying the same image, with title, source, publication date where Google shows one, the source image's pixel dimensions, a thumbnail and the resolved destination URL.\n- **Google's AI description** — the text Google's Lens result page writes about the image.\n- **Detected entity** — the subject name parsed from Google's own description, with the full description beside it.\n- **Related searches** — the follow-up questions Google suggests for the image, when the result page shows them.\n- **Detected objects** — the regions Lens found in the picture (whole image, main subject, objects, text blocks) with normalized boxes.\n- **OCR text** (optional) — the text read from the image, its language, and paragraphs with normalized boxes.\n- **Image summary** — one row per image with counts, status, warnings and the original image's dimensions.\n\n## Input\n\n| Field | Type | Description | Default |\n|---|---|---|---|\n| `mode` | select | `all`, `visualMatches`, `exactMatches`, `products` or `ocr`. | `all` |\n| `imageUrls` | array | Public direct image URLs. One or many. | |\n| `imageKeys` | array | Optional. Keys in this run's key-value store that hold image files. | |\n| `country` | select | Google market used for results and prices. | `US` |\n| `language` | select | Result language. | `en` |\n| `maxItems` | integer | Maximum match rows per image (1–1000). | `100` |\n| `includeOcr` | boolean | Add OCR text to the image summary for any mode. | `false` |\n| `rehostImages` | boolean | Copy full-size match images whose host blocks hotlinking into this run's key-value store and return a public URL, keeping the source URL in `imageUrlOriginal`. | `true` |\n\nExample:\n\n```json\n{\n  \"mode\": \"all\",\n  \"imageUrls\": [\n    \"https://images.unsplash.com/photo-1502602898657-3e91760cbb34?w=640\"\n  ],\n  \"country\": \"US\",\n  \"language\": \"en\",\n  \"maxItems\": 50,\n  \"includeOcr\": false\n}\n```\n\n## Output\n\nEach dataset row is a match or an image summary.\n\n```json\n{\n  \"recordType\": \"match\",\n  \"matchType\": \"visual\",\n  \"position\": 1,\n  \"inputImageUrl\": \"https://example.com/photo.jpg\",\n  \"title\": \"A guide to flying to France | Documents, Distance, Airports\",\n  \"source\": \"Sherburn Aero Club\",\n  \"domain\": \"sherburnaeroclub.com\",\n  \"pageUrl\": \"https://sherburnaeroclub.com/blog/a-guide-to-flying-to-france\",\n  \"thumbnailUrl\": \"https://encrypted-tbn0.gstatic.com/images?q=tbn:...\",\n  \"imageUrl\": \"https://sherburnaeroclub.com/storage/medialibrary/flying-to-france.jpg\",\n  \"imageWidth\": 3530,\n  \"imageHeight\": 5309,\n  \"searchCountry\": \"US\",\n  \"searchLanguage\": \"en\",\n  \"scrapedAt\": \"2026-11-15T00:00:00+00:00\"\n}\n```\n\nProduct matches add `price`, `currency`, `currencyCode`, `priceText`, `merchant`, `rating`, `reviewCount` and `inStock`. Exact matches add `date`, `googleRedirectUrl` and the source image dimensions. When a full-size match image had to be copied into storage, `imageUrlOriginal` keeps the source URL. The image summary row adds `aiOverview`, `knowledgeEntity`, `relatedSearches`, `detectedObjects`, `ocr`, `counts` and `status`.\n\n## Modes\n\n| Mode | What it returns |\n|---|---|\n| `all` | Visual matches, product offers, AI description, entity, related searches and detected objects. |\n| `visualMatches` | Visual matches and product offers only. Faster than `all`. |\n| `exactMatches` | Pages carrying the same image, up to Google's 400-row source ceiling. |\n| `products` | Only visual matches that carry a price. |\n| `ocr` | Only OCR text, language and paragraph boxes. No browser session needed. |\n\nAdd `includeOcr: true` to any non-OCR mode to attach OCR to the image summary.\n\n## Use cases\n\n- Find where a photo appears on the web and who published it.\n- Check whether your product photography is being reused by other sellers.\n- Turn a product photo into a list of similar listings with prices and stock.\n- Read text from screenshots, signs, labels and documents without a separate OCR tool.\n- Enrich a catalogue with visually similar pages and the entity Google recognizes.\n- Feed an AI agent structured visual-search results instead of raw HTML.\n\n## How it works\n\nThe actor prepares each image the same way Google's own upload widget does, sends it to Google Lens, and reads the result page's embedded match map plus its visible cards. Exact-match destination links are resolved from Google's redirect wrapper without visiting the merchant site. OCR uses Google's Chromium Lens endpoint. No Google account, cookie or API key is required.\n\n## Limitations\n\n- **Visual matches are capped by Google.** One lookup returns about 60 visual matches. A larger `maxItems` does not create more source results.\n- **Exact matches are capped at 400 and can be empty.** Google returns an exact set for some images and nothing for others; the same image can change between lookups.\n- **The separate Products tab was retired by Google in October 2026.** Product offers now arrive inside visual matches, so `products` filters price-bearing visual matches instead of opening a Products tab.\n- **Product fields are shown only when the retailer publishes them.** Price, rating, review count and stock are omitted when Google does not display them.\n- **A separate Knowledge Graph entity card is no longer shown.** The actor returns Google's AI description and derives the subject name from that description; when no name can be parsed, only the description is returned.\n- **Related searches appear as AI follow-up questions when Google shows them.** The current Lens page does not always include them.\n- **Image URLs must be public and direct.** Login-protected links, private hosts and web pages that merely contain an image are rejected.\n- **Full-size match images belong to their source sites.** Thumbnails are Google-hosted and always public. With `rehostImages` on (the default), images whose host blocks hotlinking are copied into the run's key-value store and returned as public URLs; `imageUrlOriginal` keeps the source link. An image that cannot be fetched at all is omitted rather than replaced by a broken link.\n- **Google sometimes asks for a captcha.** The actor retries with new sessions and connections; if Google refuses every attempt, the image summary says so and no match rows are saved for that image.\n- **OCR is a best-effort read.** Stylized text, very small type and low-contrast images may produce little or no text.\n\n## FAQ\n\n**Do I need a Google account or API key?** No.\n\n**Can I search an image stored on my computer?** Yes. Put the file in the run's key-value store and pass its key in `imageKeys`.\n\n**Why did an exact-match lookup return nothing?** Google does not have an exact set for every image, and the set changes over time. Try the same image later or use `visualMatches`.\n\n**Why are some product fields missing?** Google only shows a price, rating, review count or stock label when the listing publishes it.\n\n**Can I get more than 60 visual matches?** No. That is Google's source ceiling, not an actor setting.\n\n**What does `status` mean on the image summary?** `ok` means the result set was collected. `partial` means a secondary part (for example the AI description or exact tab) was unavailable. `blocked` means Google refused the Lens page for every connection. `error` means the image itself could not be loaded.\n\n**Are thumbnails and full-size image URLs usable outside Apify?** Thumbnails are public Google-hosted images. Full-size URLs point at the source site and may be protected by that site.\n\n## Data source\n\nResults come from public Google Lens pages. This actor is independent and is not affiliated with, endorsed by, or sponsored by Google LLC. Google Lens is a trademark of Google LLC.\n",
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "fields": {},
          "views": {
            "overview": {
              "title": "Matches",
              "transformation": {
                "fields": [
                  "recordType",
                  "matchType",
                  "position",
                  "inputImageUrl",
                  "title",
                  "source",
                  "domain",
                  "pageUrl",
                  "price",
                  "currency",
                  "rating",
                  "reviewCount",
                  "inStock",
                  "date",
                  "imageUrlOriginal",
                  "thumbnailUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            },
            "images": {
              "title": "Image summaries",
              "transformation": {
                "fields": [
                  "recordType",
                  "inputImageUrl",
                  "mode",
                  "status",
                  "counts",
                  "knowledgeEntity",
                  "relatedSearches",
                  "ocr"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      }
    },
    "buildNumber": "1.0.12",
    "imageDigest": "e7e7b02611be066e18e20f3c36fdbd2c1660af584d2d25e539b1f28a9ecaa8b6",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.04685333333333333
    }
  }
}