{ "openapi": "3.0.1", "info": { "title": "Yandex Reverse Image Search - FREE", "description": "Find where any image appears online. Search by picture instead of keywords: paste a link or upload a file and get matching pages, visually similar images, other resolutions, text read from the picture, and descriptive tags.", "version": "0.0", "x-build-id": "bfpxUpYN8u0FHJqDr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dz_omar~yandex-reverse-image-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dz_omar-yandex-reverse-image-search", "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/dz_omar~yandex-reverse-image-search/runs": { "post": { "operationId": "runs-sync-dz_omar-yandex-reverse-image-search", "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/dz_omar~yandex-reverse-image-search/run-sync": { "post": { "operationId": "run-sync-dz_omar-yandex-reverse-image-search", "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": { "imageUrl": { "title": "๐Ÿ”— Image URL", "type": "string", "description": "The web address of the image you want to search for. Right-click any picture in your browser and choose 'Copy image address', then paste it here. The link must be publicly reachable โ€” a private or password-protected link will not work. Leave this empty if you are uploading a file below." }, "imageFile": { "title": "๐Ÿ“ Or upload an image file", "type": "string", "description": "Upload a picture from your computer instead of pasting a link. Accepts JPG, PNG, WebP, GIF and BMP, up to about 10 MB. Use this for screenshots, photos, or any image that is not already published online." }, "crop": { "title": "โœ‚๏ธ Search only part of the image", "pattern": "^$|^\\s*(0(\\.\\d+)?|1(\\.0+)?)(\\s*;\\s*(0(\\.\\d+)?|1(\\.0+)?)){3}\\s*$", "type": "string", "description": "Optional. Search a rectangle inside the picture instead of the whole thing โ€” useful when one object in a busy photo is what you care about. Four numbers between 0 and 1 separated by semicolons: left;top;right;bottom. For example 0.25;0.25;0.75;0.75 searches the middle. Leave empty to search the whole image." }, "searchRegions": { "title": "๐ŸŒ Search regions", "type": "array", "description": "Which regional Yandex indexes to search. Leave as-is for most uses. Adding Turkey is the single best way to find more results, because it searches a largely different index โ€” expect roughly 75% more unique matches. The Russia, Belarus, Kazakhstan and Uzbekistan indexes overlap almost entirely with the International one, so adding them returns only a handful of extra results. Each extra region makes the run take a little longer. Picking 'All regions' searches every index and overrides the other choices.", "items": { "type": "string", "enum": [ "yandex.com", "yandex.com.tr", "yandex.ru", "yandex.by", "yandex.kz", "yandex.uz", "all" ], "enumTitles": [ "International โ€” yandex.com (recommended)", "Turkey โ€” yandex.com.tr (adds the most new results)", "Russia โ€” yandex.ru", "Belarus โ€” yandex.by", "Kazakhstan โ€” yandex.kz", "Uzbekistan โ€” yandex.uz", "All regions โ€” every index at once (slowest, most results)" ] }, "default": [ "yandex.com" ] }, "resultTypes": { "title": "๐Ÿ“ฆ Result types", "type": "array", "description": "What kind of results you want back. Every result is one row in the dataset, labelled with a 'resultType' column so you can filter them. 'Pages containing this image' and 'Visually similar images' are on by default and cover most needs.", "items": { "type": "string", "enum": [ "matchingPages", "similarImages", "imageSizes", "imageTags", "ocrText", "classification", "barcodes", "detectedObjects" ], "enumTitles": [ "Pages containing this image โ€” where it appears online", "Visually similar images โ€” lookalikes from across the web", "Other sizes โ€” the same image in higher or lower resolution", "Image tags โ€” words describing what is in the picture", "Text in the image โ€” reads any writing, with its position", "Image classification โ€” what kind of picture Yandex thinks it is", "Barcodes and QR codes โ€” only if the picture contains one", "Detected objects โ€” regions the engine spotted, with a category" ] }, "default": [ "matchingPages", "similarImages" ] }, "maxResults": { "title": "๐Ÿ“Š Maximum results", "minimum": 0, "type": "integer", "description": "The largest number of rows to take from EACH search region, not from the run as a whole. With 3 regions selected and a limit of 11, the run takes up to 11 from each, so up to 33 rows in total. Duplicate removal then runs across regions, so the final count is usually lower โ€” the same picture found in two regions becomes one row. Set to 0 for everything found: a single region can return 3,000+ rows and takes correspondingly longer. Within each region's own limit, the rows are shared fairly between the result types you selected.", "default": 50 }, "deduplicate": { "title": "๐Ÿงน Remove duplicate images", "type": "boolean", "description": "On (default): if the same picture is found on several pages, you get one row listing every page that carries it, in a 'pages' column. This removes roughly 40% of rows without losing any information. Off: one row per page, with the same image repeated many times.", "default": true } } }, "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 } } } } } } } } } }