Logo SearchApi

Yandex Reverse Image API

GET   /api/v1/search?engine=yandex_reverse_image

The Yandex Reverse Image API enables real-time scraping of visual search results from Yandex Images.

Use the Yandex Reverse Image API for tasks such as:

  • Finding visually similar images across the web.
  • Locating different sizes and resolutions of the same image.
  • Finding related search suggestions based on image content.
  • Detecting objects and products within images.

API Parameters

Search Query

  • Name
    url
    Required
    Required
    Description

    Parameter defines the image URL for reverse image search. This is the direct link to the image you want Yandex to analyze. Ensure the URL points to a valid image format (e.g., .jpg, .png, .webp) and is accessible publicly.

Filters

  • Name
    crop
    Required
    Optional
    Description

    Crops the image before reverse search. Format: left;top;right;bottom, with each value between 0 and 1. For example, 0.1;0.2;0.6;0.75 selects the region from 10% to 60% of the width and 20% to 75% of the height. Default is 0;0;1;1 (full image). left must be less than right, and top less than bottom. Cannot be used with crop_id.

  • Name
    crop_id
    Required
    Optional
    Description

    Identifies a pre-defined coordinates within an image for targeted reverse search. This parameter enables searching for a particular section that has been detected and identified by Yandex's image analysis. The crop ID corresponds to a specific area of interest within the image. Cannot be used together with crop.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to yandex_reverse_image.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Visual Matches

Visual Matches
GET
https://www.searchapi.io/api/v1/search?engine=yandex_reverse_image&url=https%3A%2F%2Fi.ibb.co%2FDrdLBQf%2F1683889779-anaclui-75ed8c7f027b6d0e7aedeed7b1b3fd94-2.jpg
Request
import requests url = "https://www.searchapi.io/api/v1/search" params = { "engine": "yandex_reverse_image", "url": "https://i.ibb.co/DrdLBQf/1683889779-anaclui-75ed8c7f027b6d0e7aedeed7b1b3fd94-2.jpg" } response = requests.get(url, params=params) print(response.text)
Response
{ "visual_matches": [ { "position": 1, "title": "Spotlight Furniture Collection Омский салют", "snippet": "Spotlight Furniture Collection ", "link": "https://omsksalut.ru/spotlight-on-the-natuzzi-editions-furniture-collection/?utm_medium=organic&utm_source=yandexsmartcamera", "source": "omsksalut.ru", "thumbnail": "https://avatars.mds.yandex.net/i?id=0da6fda3087a3713bbfe2b553ce44c49aaa369e3-8325116-images-thumbs&n=13&w=296&h=180", "image": { "link": "https://omsksalut.ru/wp-content/uploads/2020/04/blog2-1024x649.jpg", "height": 649, "width": 1024 } }, { "position": 2, "title": "Лучшая покупка, лидер продаж, Новое поступление, стол из ротанга, боковой столик для роскошной мебели для украшения дома Alibaba", "snippet": "Vintage Rattan Sofa Chair for Living Room Furniture ", "link": "https://russian.alibaba.com/product-detail/Best-Buy-Hot-Trendy-New-Arrival-62005844185.html?utm_medium=organic&utm_source=yandexsmartcamera", "source": "russian.alibaba.com", "thumbnail": "https://avatars.mds.yandex.net/i?id=1f3e5faf9f8e45d33493cf04c3ad798737f3ee4f-10701700-images-thumbs&n=13&w=296&h=180", "image": { "link": "https://s.alicdn.com/@sc04/kf/Abbee954310ae4f66af1a17d717a6721aB.jpg_350x350.jpg", "height": 350, "width": 350 } }, ... ] }

Similar Images

Similar Images
GET
https://www.searchapi.io/api/v1/search?engine=yandex_reverse_image&url=https%3A%2F%2Fstore.storeimages.cdn-apple.com%2F4982%2Fas-images.apple.com%2Fis%2Fiphone-15-pro-finish-select-202309-6-1inch-bluetitanium%3Fwid%3D2560%26hei%3D1440%26fmt%3Dp-jpg%26qlt%3D80%26.v%3D1692846360609
Request
import requests url = "https://www.searchapi.io/api/v1/search" params = { "engine": "yandex_reverse_image", "url": "https://store.storeimages.cdn-apple.com/4982/as-images.apple.com/is/iphone-15-pro-finish-select-202309-6-1inch-bluetitanium?wid=2560&hei=1440&fmt=p-jpg&qlt=80&.v=1692846360609" } response = requests.get(url, params=params) print(response.text)
Response
{ "similar_images": [ { "position": 1, "link": "https://yandex.com/images/search?url=https%3A%2F%2Favatars.mds.yandex.net%2Fget-images-cbir%2F10241557%2FcxJW5wc7K2i-boYAtKrxdA2546%2Forig&img_url=https%3A%2F%2Fistore-d.ru%2Fupload%2Fiblock%2F044%2Fkabzc5uc1wz3okykcnggrexxwoiuqszl.jpeg&rpt=imageview&lr=29642&cbir_id=10241557%2FcxJW5wc7K2i-boYAtKrxdA2546&cbir_page=similar", "thumbnail": "https://avatars.mds.yandex.net/i?id=55b871111d30c7f4f3c98737be04df0351107648-5312449-images-thumbs&n=13", "image": { "link": "https://avatars.mds.yandex.net/i?id=55b871111d30c7f4f3c98737be04df0351107648-5312449-images-thumbs&n=13", "height": 320, "width": 320 } }, { "position": 2, "link": "https://yandex.com/images/search?url=https%3A%2F%2Favatars.mds.yandex.net%2Fget-images-cbir%2F10241557%2FcxJW5wc7K2i-boYAtKrxdA2546%2Forig&img_url=https%3A%2F%2Fstatic.tildacdn.com%2Ftild3865-6637-4333-b137-323730376139%2Fimage.png&rpt=imageview&lr=29642&cbir_id=10241557%2FcxJW5wc7K2i-boYAtKrxdA2546&cbir_page=similar", "thumbnail": "https://avatars.mds.yandex.net/i?id=f7e33424a066680a68b32a34d2ac5e1ca467ac05-7570876-images-thumbs&n=13", "image": { "link": "https://avatars.mds.yandex.net/i?id=f7e33424a066680a68b32a34d2ac5e1ca467ac05-7570876-images-thumbs&n=13", "height": 320, "width": 320 } }, ... ] }

Image Sizes

Image Sizes
GET
https://www.searchapi.io/api/v1/search?engine=yandex_reverse_image&url=https%3A%2F%2Fupload.wikimedia.org%2Fwikipedia%2Fen%2F7%2F7a%2FHarry_Potter_and_the_Philosopher%2527s_Stone_banner.jpg
Request
import requests url = "https://www.searchapi.io/api/v1/search" params = { "engine": "yandex_reverse_image", "url": "https://upload.wikimedia.org/wikipedia/en/7/7a/Harry_Potter_and_the_Philosopher%27s_Stone_banner.jpg" } response = requests.get(url, params=params) print(response.text)
Response
{ "image_sizes": { "large": [ { "size": "4503×3417", "link": "https://originalvintagemovieposters.com/wp-content/uploads/2016/08/Harry-Potter-and-the-Philosophers-Stone-4547-.jpg" }, ... ], "medium": [ { "size": "1200×685", "link": "https://www.la-notizia.net/wp-content/uploads/2020/11/Harry_Potter_and_the_Philosophers_Stone_banner.jpg" }, ... ], "small": [ { "size": "650×492", "link": "https://www.reeldeals.com/images/items/harrypotter1bq.jpg" }, ... ] } }

Related Searches

Related Searches
GET
https://www.searchapi.io/api/v1/search?engine=yandex_reverse_image&url=https%3A%2F%2Fi.ibb.co%2F12qRDsk%2Ftower.png
Request
import requests url = "https://www.searchapi.io/api/v1/search" params = { "engine": "yandex_reverse_image", "url": "https://i.ibb.co/12qRDsk/tower.png" } response = requests.get(url, params=params) print(response.text)
Response
{ "related_searches": [ { "title": "эйфелева башня в париже", "link": "https://yandex.com/images/search?text=%D1%8D%D0%B9%D1%84%D0%B5%D0%BB%D0%B5%D0%B2%D0%B0%20%D0%B1%D0%B0%D1%88%D0%BD%D1%8F%20%D0%B2%20%D0%BF%D0%B0%D1%80%D0%B8%D0%B6%D0%B5" }, { "title": "eiffel tower paris", "link": "https://yandex.com/images/search?text=eiffel%20tower%20paris" }, ... ] }