{ "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, product matches with prices, or every page carrying that exact image. Pay per result, MCP ready for AI agents.", "version": "0.0", "x-build-id": "Jvg0EWUyCRgUdehVb" }, "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 and is the general reverse image search. 'Products' returns shoppable listings with prices. 'Exact matches' finds every page carrying this exact image, which is what you want for attribution and licensing checks.", "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 and products 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. One lookup returns roughly 59 visual matches, 19 products, or up to 400 exact matches, so set this to whichever slice you actually need.", "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 } } }, "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 } } } } } } } } } }