{"uid":"cap_WVrEA54kRt_7yrwZiM7KD","slug":"agents-openwebninja-com-google-lens-visual-matches-57fdcba5","name":"Google Lens Visual Matches","description":"Get visual matches from the web for an image and optionally a query. This endpoint implements the \"Visual Matches\" on Google Lens.","url":"https://agents.openwebninja.com/realtime-lens-data/visual-matches?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"URL of an image for which to get visual matches."},"query":{"type":"string","description":"Search query to further refine the results."},"country":{"type":"string","default":"us","description":"Set the country for the search (Google's gl parameter). Allowed values: 2-letter country code, see ISO 3166."},"language":{"type":"string","default":"en","description":"Set the language of the results (Google's hl parameter). Allowed values: 2-letter language code, see ISO 639-1."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string","description":"Canonical URL of the matched page."},"image":{"type":"string","description":"Direct URL to the matched full-size image."},"title":{"type":"string","description":"Title of the matched page."},"source":{"type":"string","description":"Domain of the source page."},"position":{"type":"integer","description":"1-based position of the match."},"thumbnail":{"type":"string","description":"Google-hosted thumbnail URL for the matched image."},"image_width":{"type":"integer","description":"Width of the matched image in pixels."},"source_icon":{"type":"string","nullable":true,"description":"Favicon URL for the source."},"image_height":{"type":"integer","description":"Height of the matched image in pixels."},"thumbnail_width":{"type":"integer","description":"Width of the thumbnail in pixels."},"thumbnail_height":{"type":"integer","description":"Height of the thumbnail in pixels."}}},"description":"A list of visual matches found for the supplied image."},"status":{"type":"string","description":"The status of the response"},"parameters":{"type":"object","properties":{"url":{"type":"string","description":"The image URL used for the query"},"country":{"type":"string","description":"The country code associated with the request"},"language":{"type":"string","description":"The language code used in the request"}}},"request_id":{"type":"string","description":"The unique identifier for this API request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_Y7CIOOLjT6WP_uVnCIyGg","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Returns ranked visual match results from the web for a given image URL, optionally refined by a text query, using Google Lens under the hood.","exampleAgentPrompt":"Can you do a Google Lens reverse image search on this photo — https://example.com/shoe.jpg — and find me all the websites where this image or something visually similar appears, focused on US results in English?","exampleUseCases":[{"title":"Identify product from photo","prompt":"I have an image of a chair I saw at a friend's place — https://example.com/chair.jpg — can you use Google Lens to find where this chair is sold online and what it's called?"},{"title":"Find original source of viral photo","prompt":"Someone sent me this image — https://example.com/viral-photo.jpg — can you do a reverse image search and tell me where it originally came from and which sites have used it?"},{"title":"Spot counterfeit product listing","prompt":"Here's the product image from a suspicious seller: https://example.com/product.jpg — can you search Google Lens and see if the same image shows up on legitimate retail sites so I can check if it's counterfeit?"}],"resultDescription":"Returns a ranked list of visual matches, each containing the matched page URL, direct image URL, page title, source domain, 1-based position, Google-hosted thumbnail URL, thumbnail and image dimensions, and an optional favicon URL for the source site. Also includes echoed request parameters and a unique request ID.","failureModes":["Invalid or inaccessible image URL returns an error or empty results","Image URL that is too large or in an unsupported format may fail to process","Invalid country or language codes may produce unexpected results or errors","Rate limits or payment issues result in 402 or 429 errors","Private or localhost image URLs are not accessible to the API"],"whenToPreferThis":"Choose this endpoint when you need to perform a Google Lens-style visual/reverse image search — finding web pages, product listings, or sources that feature a specific image — especially when you also want to refine results with a text query or localize by country and language. Prefer this over generic text-based search APIs when the input is an image rather than text, and over other reverse image search tools when Google Lens coverage and ranking are desired.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:37:04.872Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-google-lens-visual-matches-57fdcba5"}