Yandex Reverse Image Search API
Search Yandex by image. Give an image URL and get every page where it appears online, visually similar images, other sizes, matching shop products, and image tags as clean JSON. Crop-box targeting, 6 regional domains, pay per result.
MEDIAN LAGon demand
PARAMETERS10
TOTAL USERS48
MONTHLY ACTIVE15
TOTAL RUNS207
RUNS SUCCEEDED96.2%
RATING5.0 (1)
Input parameters
| PARAMETER | TYPE | REQ | DEFAULT | DESCRIPTION |
|---|---|---|---|---|
| image_url | string | yes | — | Provide the public http(s) URL of the image to search by. |
| crop | string | no | — | Optionally crop the image before searching, as four ';'-separated fractions between 0 and 1 in the order left;top;right;bottom. |
| include_matching_pages | boolean | no | True | Return pages where this image (or a close match) appears online, with page title, link, and snippet. |
| include_similar_images | boolean | no | True | Return visually similar images from across the web, with thumbnails and links. |
| include_image_sizes | boolean | no | False | Return other resolutions of the same image, categorized large / medium / small. |
| include_image_tags | boolean | no | False | Return suggested search terms describing what is in the image. |
| include_shopping_results | boolean | no | False | Return e-commerce products that match the image content, with prices where available. |
| include_knowledge_graph | boolean | no | False | Return the entity card when the image contains a recognizable subject (a person, landmark, product, or brand). |
| yandex_domain | enum | no | yandex.com | The regional Yandex domain to search from. |
| max_results | integer | no | 0 | Cap the total number of result rows returned (and billed) by this run. 0 (the default) returns everything the search found for your selected result types. — drives your bill |
Worked examples
{
"image_url": "https://substack-post-media.s3.amazonaws.com/public/images/edbfb2cd-ebcb-4527-bec7-5315c182278f_445x445.png"
}
Coverage
6
yandex domain — yandex.com yandex.ru yandex.by yandex.kz yandex.uz +1
Tasks
Saved runs with the inputs already filled in — each one a standalone page and a working configuration example.
Code
curl
curl -X POST "https://api.apify.com/v2/acts/johnvc~yandex-reverse-image-search/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"image_url": "https://substack-post-media.s3.amazonaws.com/public/images/edbfb2cd-ebcb-4527-bec7-5315c182278f_445x445.png"}'
Python
from apify_client import ApifyClient
client = ApifyClient("APIFY_TOKEN")
run = client.actor("johnvc/yandex-reverse-image-search").call(
run_input={'image_url': 'https://substack-post-media.s3.amazonaws.com/public/images/edbfb2cd-ebcb-4527-bec7-5315c182278f_445x445.png'}
)
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)