{ "openapi": "3.0.1", "info": { "title": "Google Lens API | Reverse Image and Visual Product Search", "description": "Google Lens API for reverse image search and visual product search. Upload images from your computer or send base64 from code, no public URL needed, up to 10 per run. Get similar results, shop listings with prices, or every page carrying that exact image. Pay per result, MCP ready for AI agents.", "version": "0.0", "x-build-id": "tB0y2Bw1H2pmuK6kI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~google-lens-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-google-lens-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/johnvc~google-lens-api/runs": { "post": { "operationId": "runs-sync-johnvc-google-lens-api", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/johnvc~google-lens-api/run-sync": { "post": { "operationId": "run-sync-johnvc-google-lens-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "image_url": { "title": "Image URL", "type": "string", "description": "A public http or https link to the image you want to look up. The image must be reachable without a login. Also accepts a data URI (data:image/png;base64,...). Provide images through exactly one of Image URL, Upload images, or Image base64." }, "image_upload": { "title": "Upload images", "type": "array", "description": "Click Upload new files and pick up to 10 images from your computer, or paste links to files already stored on Apify. When set, this takes priority over Image URL." }, "image_base64": { "title": "Image base64", "type": "array", "description": "Raw image bytes encoded as base64, one entry per image, with or without the data:image/...;base64, prefix. Best for API, MCP, and automation callers that hold local files. The platform caps run input at 9 MB, so this door fits about 6 MB of images per run; for bigger files use Upload images. When set, this takes priority over Image URL.", "items": { "type": "string" } }, "search_type": { "title": "Search type", "enum": [ "visual_matches", "products", "exact_matches" ], "type": "string", "description": "What kind of matches to return. 'Visual matches' finds visually similar images, including shoppable listings with prices where the retailer publishes them, and is the general reverse image search. 'Exact matches' finds every page carrying this exact image, which is what you want for attribution and licensing checks. 'Products' was retired by Google in October 2026 and now returns an error row with nothing billed; use 'Visual matches' instead.", "default": "visual_matches" }, "query": { "title": "Refine with text", "type": "string", "description": "Optional. Add words to narrow the results, for example 'blue' or 'leather'. Applies to visual matches only; the source ignores it for exact matches." }, "max_results": { "title": "Maximum results", "minimum": 1, "maximum": 400, "type": "integer", "description": "How many matches to return per image. One lookup returns up to about 60 visual matches or up to 400 exact matches, so this trims rather than pages. Each image searched is billed at least 50 visual matches or 40 exact matches, even when fewer are found, so smaller values are raised to that minimum and you receive the rows you pay for.", "default": 50 }, "country": { "title": "Country", "type": "string", "description": "Optional two letter country code such as us, gb or de. Affects which regional results and shopping listings are returned." }, "language": { "title": "Language", "type": "string", "description": "Optional two letter language code such as en, es or fr. Note that match coverage genuinely varies by language: some languages return fewer results for the same image." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }