Submit a public image URL and retrieve visually similar results, matching products, source pages, prices, thumbnails, and related searches through one structured API endpoint.
Use the same API key and credit balance across every ScrapeBadger API.
{
"image_url": "https://images.example.com/chair.jpg",
"lens_results": [
{
"position": 1,
"title": "Example wooden lounge chair",
"link": "https://shop.example.com/chair",
"source": "Example Store",
"thumbnail": "https://images.example.com/result.jpg",
"price": {
"value": 349.99,
"currency": "USD",
"extracted": "$349.99"
},
"in_stock": true
}
]
}Search by image, refine the visual query, and choose between broader visual matches, product-focused results, and exact matches.
/v1/google/lens/search7 creditsSearch Google Lens using a public image URL. Results can include visually related pages and products with source links, thumbnails, tags, prices, stock status, ratings, reviews, and related searches.
url | required | Publicly accessible URL of the image to search. |
query | optional | Text used to refine the visual search. |
product | optional | Set to true to favour shoppable product matches. |
visual_matches | optional | Include the visual-matches results. Defaults to true. |
curl --get \
'https://scrapebadger.com/v1/google/lens/search' \
--data-urlencode 'url=https://images.example.com/chair.jpg' \
--data-urlencode 'visual_matches=true' \
--data-urlencode 'gl=us' \
--data-urlencode 'hl=en' \
--header 'x-api-key: YOUR_API_KEY'{
"image_url": "https://images.example.com/chair.jpg",
"lens_results": [
{
"position": 1,
"title": "Example wooden lounge chair",
"link": "https://shop.example.com/example-chair",
"source": "Example Store",
"source_favicon": "https://images.example.com/store-favicon.png",
"thumbnail": "https://images.example.com/chair-thumbnail.jpg",
"original_thumbnail": "https://images.example.com/chair-original.jpg",
"tag": "Lounge chair",
"price": {
"value": 349.99,
"currency": "USD",
"extracted": "$349.99"
},
"in_stock": true,
"rating": "4.6",
"reviews": "248"
}
],
"results": [
{
"position": 1,
"title": "Example wooden lounge chair",
"link": "https://shop.example.com/example-chair",
"source": "Example Store",
"source_favicon": "https://images.example.com/store-favicon.png",
"thumbnail": "https://images.example.com/chair-thumbnail.jpg",
"original_thumbnail": "https://images.example.com/chair-original.jpg",
"tag": "Lounge chair",
"price": {
"value": 349.99,
"currency": "USD",
"extracted": "$349.99"
},
"in_stock": true,
"rating": "4.6",
"reviews": "248"
}
],
"related_searches": [
{
"title": "Mid-century lounge chairs",
"link": "https://www.google.com/search?q=mid-century+lounge+chairs",
"thumbnail": "https://images.example.com/related-chair.jpg"
}
]
}Submit a product image and retrieve visually similar items from available merchants and source pages. Use product mode when the workflow needs to favour shoppable results.
Find pages Google Lens associates with an image. Use exact-match mode when researching where the same image may appear online.
Compare official product images with visually similar listings from other sources. Use the results to identify listings that require manual review without treating visual similarity as proof that an item is counterfeit.
Connect product or asset images with similar pages, products, tags, prices, and related visual searches. Use this information to support catalogue review, product matching, or visual discovery features.
1,000 free credits · No credit card required
Use the same ScrapeBadger account, API key, and credit balance to connect image-based discovery with keyword image search, product listings, seller offers, and wider web results.
Search Google Images using a text query and retrieve image URLs, thumbnails, titles, source pages, dimensions, and available image filters.
Explore the Google Images API →Search Google Shopping for product listings, identifiers, prices, merchants, ratings, images, and available filters.
Explore the Google Shopping Search API →Retrieve detailed product information, specifications, images, seller offers, variants, and available merchant destinations.
Explore the Google Immersive Product API →Search the wider Google web index for product names, source pages, brands, or topics identified during a Lens search.
Explore the Google Search API →Structured JSON responses remove browser automation, proxy orchestration, and HTML parsing from your roadmap. Make your first request in minutes and move from proof of concept to production without maintaining scrapers.
99.9% uptime SLA. Your data pipeline does not stop because Google changes a page, rotates an anti-bot challenge, or moves a result block. Monitoring, session management, browser infrastructure, and parsing are all us.
Search, Maps, News, Hotels, Trends, Jobs, Shopping, Patents, Scholar, Images, Videos, Finance, AI Mode, Lens, Local, Shorts, Flights, Products, and Autocomplete — every Google surface under one API key.
RESTful API, SDK support, MCP, CLI, and no-code options. Use ScrapeBadger in an existing system or a new application with consistent authentication, structured JSON, and unified billing.
Use ScrapeBadger through an official SDK, a standard API request, MCP, CLI, or the tools already in your workflow.
Build asynchronous data pipelines with typed responses, retry handling, and access to the complete Google API suite.
Add Google data to Node.js and TypeScript applications with type definitions and support for both ESM and CommonJS.
Connect from any backend or programming language using standard HTTP requests. Responses arrive as structured JSON that can be stored, transformed, or passed into another service.
Access Search, Maps, News, Trends, Shopping, Scholar, Flights, and every other supported Google product with one ScrapeBadger API key and one credit balance.
Give compatible AI agents access to Google Search, Maps, News, Trends, Shopping, Scholar, Images, Flights, and more through ScrapeBadger's MCP server.
Run Google searches, inspect trends, collect local business data, and export results as JSON, CSV, Markdown, or terminal-friendly tables without building an application.
See why developers choose ScrapeBadger for reliable, structured web data.
“We switched from the official Twitter API and cut our costs by 95%. The pagination is seamless, and we've never hit a rate limit. Best decision we made this year.”
“The follower and engagement endpoints are incredibly detailed. We use it for influencer research and competitor analysis. Response times are sub-100ms consistently.”
“Started with the Apify actor, then moved to the API for more control. The 1,000 free credits were enough to build our MVP. Now processing 2M+ tweets monthly.”
“Perfect for academic research. The community and trends endpoints give us data we couldn't get anywhere else. Documentation could use more examples, but support is responsive.”
“We monitor 50,000+ accounts for our clients. ScrapeBadger handles it without breaking a sweat. The bulk ID endpoints are a game-changer for large-scale monitoring.”
“The geo and trends endpoints power our location-based analytics. Setup took 10 minutes. Their Apify actors are also great for quick one-off scrapes.”
Start with pay-as-you-go credits (never expire) or save up to 64% with a monthly or annual subscription. Failed requests never consume credits, and every Google API endpoint is included on every plan.
Choose an endpoint and enter your expected request volume. Google APIs use flat per-request credits, making usage easy to forecast. Failed requests cost 0 credits.
Everything you need to know about the Lens API.
url parameter must point to an image that Google Lens and ScrapeBadger can access publicly. Images stored only on your device, protected by a login, restricted to a private network, or blocked from external access cannot be searched directly.visual_matches=true includes broader results that Google considers visually related to the submitted image. product=true biases the results towards shoppable product matches, while exact_matches=true restricts the search to exact matches. Product mode and exact-match mode can reduce or change the returned result set.lens_results and results are documented arrays containing the same Lens result structure. Depending on the response, they may contain overlapping matches. Applications that process both arrays should deduplicate results using fields such as the destination link.Use 1,000 free credits to search by image, find visually similar results, discover matching products, research source pages, and retrieve structured Google Lens data.
No credit card required · Failed requests cost 0 credits
Disclaimer: ScrapeBadger is not affiliated with, endorsed by, or in any way officially connected with Google LLC or any of its subsidiaries or affiliates. Google and related trademarks are the property of their respective owners.