Yandex Reverse Image API

Yandex Reverse Image API allows you to get results for an image search. When we query Yandex Images API with the URL of the image, we can get results such as image_preview, image_results, image_sizes,image_sizes_message, shopping_results, image_tags, similar_images, and knowledge_graph. They are parsed and exist within the JSON output.

To scrape Yandex Reverse Image with SerpApi, create a search with these parameters:

API Parameters

url

Required

Parameter defines the URL for an image to perform the reverse image search.

crop

Optional

Parameter is used to crop the image and perform the reverse search on the cropped part of the image. E.g. 0.04;0.46;0.27;0.84.
These coordinates are formatted in the next order: left edge;top edge;right edge;bottom edge. The minimum and maximum for each coordinate are 0 and 1, respectively.

crop_id

Optional

Parameter is used to filter results by a specific section of an image. Parameter will only work with images uploaded by Yandex (e.g. https://avatars.mds.yandex.net/rest-of-the-image-url).

crop and crop_id parameters should not be used together.

API Examples

Results overview

Results overview

JSON Example

{
  "search_metadata": {
    "id": "63036f46de983400a8612f2e",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/04bec3045036cebb/63036f46de983400a8612f2e.json",
    "created_at": "2022-08-22 11:57:58 UTC",
    "processed_at": "2022-08-22 11:57:59 UTC",
    "yandex_images_url": "https://yandex.com/images/search/?url=https://img1.goodfon.com/original/5616x3744/2/1e/kofe-napitok-sahar-chashka.jpg&rpt=imageview",
    "raw_html_file": "https://serpapi.com/searches/04bec3045036cebb/63036f46de983400a8612f2e.html",
    "total_time_taken": 2.14
  },
  "search_parameters": {
    "engine": "yandex_images",
    "url": "https://img1.goodfon.com/original/5616x3744/2/1e/kofe-napitok-sahar-chashka.jpg"
  },
  "image_preview": {
    "image": {
      "link": "https://avatars.mds.yandex.net/get-images-cbir/2052465/0LugLEh6nRjejDB3uK6Vxg9480/orig",
      "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Favatars.mds.yandex.net%2Fget-images-cbir%2F2052465%2F0LugLEh6nRjejDB3uK6Vxg9480%2Forig",
      "height": 5616,
      "width": 3744
    },
    "crops": [
      {
        "category": "кухонные принадлежности",
        "is_product": true,
        "crop_id": 0,
        "crop": "0.3917459846;0.1636256874;0.8530742526;0.7154867649",
        "serpapi_link": "https://serpapi.com/search.json?crop_id=0&engine=yandex_images&url=https%3A%2F%2Favatars.mds.yandex.net%2Fget-images-cbir%2F1647734%2F0LugLEh6nRjejDB3uK6Vxg6989%2Forig"
      },
      {
        "category": "еда",
        "is_product": true,
        "crop_id": 2,
        "crop": "0.1874042153;0.6628236771;0.2911816537;0.7975507975",
        "serpapi_link": "https://serpapi.com/search.json?crop_id=2&engine=yandex_images&url=https%3A%2F%2Favatars.mds.yandex.net%2Fget-images-cbir%2F1647734%2F0LugLEh6nRjejDB3uK6Vxg6989%2Forig"
      }
    ]
  },
  "image_results": [
    {
      "title": "Download wallpaper coffee, Cup, sugar, drink, section food in resolution 5616x3744",
      "snippet": "Download wallpaper coffee, Cup, sugar, drink, section food in resolution 5616x3744 ",
      "link": "https://avto.goodfon.com/download/kofe-napitok-sahar-chashka/5616x3744/",
      "source": "avto.goodfon.com",
      "thumbnail": {
        "link": "https://avatars.mds.yandex.net/i?id=2546ea722f368a7b4bd05a231c5b73d9-5310530-images-thumbs",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Favatars.mds.yandex.net%2Fi%3Fid%3D2546ea722f368a7b4bd05a231c5b73d9-5310530-images-thumbs",
        "height": 100,
        "width": 150
      },
      "original_image": {
        "link": "https://img1.goodfon.com/original/5616x3744/2/1e/kofe-napitok-sahar-chashka.jpg",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Fimg1.goodfon.com%2Foriginal%2F5616x3744%2F2%2F1e%2Fkofe-napitok-sahar-chashka.jpg",
        "height": 3744,
        "width": 5616
      }
    },
    {
      "title": "Кофе способен защитить организм человека от образования камней в почках - Solenka.info - Мировые новости и светская хроника шоу-",
      "link": "https://solenka.info/kofe-pomozhet-zashhitit-organizm-cheloveka-ot-obrazovanija-kamnej-v-pochkah.html",
      "source": "solenka.info",
      "thumbnail": {
        "link": "https://avatars.mds.yandex.net/i?id=61e7e89fdff41ff572b5e0b968184f99-5275568-images-thumbs",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Favatars.mds.yandex.net%2Fi%3Fid%3D61e7e89fdff41ff572b5e0b968184f99-5275568-images-thumbs",
        "height": 93,
        "width": 150
      },
      "original_image": {
        "link": "https://solenka.info/wp-content/uploads/2021/10/kofe-bez-kofeina-poleznye-svojstva-i-protivopokazaniya-1.jpg",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Fsolenka.info%2Fwp-content%2Fuploads%2F2021%2F10%2Fkofe-bez-kofeina-poleznye-svojstva-i-protivopokazaniya-1.jpg",
        "height": 1200,
        "width": 1920
      }
    },
    {
      "title": "Ответы Mail.ru: Вы можете прожить без кофе? и чем то его заменить?",
      "snippet": "Ответы Mail.ru: Вы можете прожить без кофе? и чем то его заменить? ",
      "link": "https://otvet.mail.ru/question/213974089",
      "source": "otvet.mail.ru",
      "thumbnail": {
        "link": "https://avatars.mds.yandex.net/i?id=28ea54bb0ee2086e22d5672566784991-4216669-images-thumbs",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Favatars.mds.yandex.net%2Fi%3Fid%3D28ea54bb0ee2086e22d5672566784991-4216669-images-thumbs",
        "height": 93,
        "width": 150
      },
      "original_image": {
        "link": "https://otvet.imgsmail.ru/download/u_a615293f7cf515f30749ed4f2f3c156a.jpg",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Fotvet.imgsmail.ru%2Fdownload%2Fu_a615293f7cf515f30749ed4f2f3c156a.jpg",
        "height": 1200,
        "width": 1920
      }
    },
    ...
  ],
  "image_sizes": {
    "large": [
      {
        "size": "5616×3744",
        "link": "https://img1.goodfon.com/original/5616x3744/2/1e/kofe-napitok-sahar-chashka.jpg",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Fimg1.goodfon.com%2Foriginal%2F5616x3744%2F2%2F1e%2Fkofe-napitok-sahar-chashka.jpg"
      },
      {
        "size": "3840×2160",
        "link": "https://storge.pic2.me/upload/516/61995aaef396d8.70219121.jpg",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Fstorge.pic2.me%2Fupload%2F516%2F61995aaef396d8.70219121.jpg"
      },
      {
        "size": "3000×2000",
        "link": "https://ne-kurim.ru/forum/attachments/1560352526727-png.926429/",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Fne-kurim.ru%2Fforum%2Fattachments%2F1560352526727-png.926429%2F"
      },
      ...
    ],
    "medium": [
      {
        "size": "1200×750",
        "link": "https://avatars.mds.yandex.net/get-zen_doc/4457971/pub_62356f7207c2780d76c04974_62356f9bc0d1f063017c9e86/scale_1200",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Favatars.mds.yandex.net%2Fget-zen_doc%2F4457971%2Fpub_62356f7207c2780d76c04974_62356f9bc0d1f063017c9e86%2Fscale_1200"
      },
      {
        "size": "1080×800",
        "link": "https://pbs.twimg.com/media/FPJNs5hWUAY6dZE.jpg",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Fpbs.twimg.com%2Fmedia%2FFPJNs5hWUAY6dZE.jpg"
      },
      {
        "size": "1235×692",
        "link": "https://u.9111s.ru/uploads/202202/02/214501130e6216279946abbcaaa6bb3f.jpg",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Fu.9111s.ru%2Fuploads%2F202202%2F02%2F214501130e6216279946abbcaaa6bb3f.jpg"
      },
      ...
    ],
    "small": [
      {
        "size": "768×432",
        "link": "https://www.afdal.best/wp-content/uploads/2022/05/%D8%A3%D9%81%D8%B6%D9%84-10-%D8%A3%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D9%82%D9%87%D9%88%D8%A9-%D8%A7%D9%84%D9%81%D8%B1%D9%86%D8%B3%D9%8A%D8%A9-%D9%81%D9%8A-%D9%85%D8%B5%D8%B1-768x432.webp",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Fwww.afdal.best%2Fwp-content%2Fuploads%2F2022%2F05%2F%25D8%25A3%25D9%2581%25D8%25B6%25D9%2584-10-%25D8%25A3%25D9%2586%25D9%2588%25D8%25A7%25D8%25B9-%25D8%25A7%25D9%2584%25D9%2582%25D9%2587%25D9%2588%25D8%25A9-%25D8%25A7%25D9%2584%25D9%2581%25D8%25B1%25D9%2586%25D8%25B3%25D9%258A%25D8%25A9-%25D9%2581%25D9%258A-%25D9%2585%25D8%25B5%25D8%25B1-768x432.webp"
      },
      {
        "size": "670×483",
        "link": "https://ostrov-sladostey.ru/wp-content/uploads/kogda-pit-kofe2.jpg",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Fostrov-sladostey.ru%2Fwp-content%2Fuploads%2Fkogda-pit-kofe2.jpg"
      },
      {
        "size": "800×400",
        "link": "https://storinka.com.ua/storage/source/10/_nuaOeQggJTwOo2pq6HJhvij39iMR64L.jpg",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Fstorinka.com.ua%2Fstorage%2Fsource%2F10%2F_nuaOeQggJTwOo2pq6HJhvij39iMR64L.jpg"
      },
      ...
    ]
  },
  "shopping_results": {
    "category": "products",
    "crops": [
      {
        "category": "Full image",
        "link": "https://yandex.com/images/search/?rpt=imageview&url=https%3A%2F%2Favatars.mds.yandex.net%2Fget-images-cbir%2F2052465%2F0LugLEh6nRjejDB3uK6Vxg9480%2Forig&cbir_page=products"
      },
      {
        "category": "Кухонные принадлежности",
        "link": "https://yandex.com/images/search/?rpt=imageview&url=https%3A%2F%2Favatars.mds.yandex.net%2Fget-images-cbir%2F2052465%2F0LugLEh6nRjejDB3uK6Vxg9480%2Forig&crop_id=0&cbir_page=products",
        "crop_id": "0",
        "crop": "0.3917459846;0.1636257172;0.8530741334;0.7154867649"
      },
      {
        "category": "Еда",
        "link": "https://yandex.com/images/search/?rpt=imageview&url=https%3A%2F%2Favatars.mds.yandex.net%2Fget-images-cbir%2F2052465%2F0LugLEh6nRjejDB3uK6Vxg9480%2Forig&crop_id=2&cbir_page=products",
        "crop_id": "2",
        "crop": "0.1874042153;0.6628236771;0.2911816537;0.7975507975"
      }
    ],
    "products": [
      {
        "title": "Красный апельсин / кофе в зернах / кофе зерновой / турецкий кофе / кофе / зерновой кофе / кофе зерновое / зерновое кофе / вкусный кофе",
        "link": "https://market.yandex.com/product--krasnyi-apelsin-kofe-v-zernakh-kofe-zernovoi-turetskii-kofe-kofe-zernovoi-kofe-kofe-zernovoe-zernovoe-kofe-vkusnyi-kofe/1736564256?utm_source_service=img&icookie=Ob4bXHskJqp%2Fawu7kmhWuwNd3JzVaUBHGJU4iHnlgNFHjHITKSHV8XiopeuQuc9advZmjm2OdlAC%2FOEpBnQknwZmJfs%3D&wprid=1661169480665375-8631934596106796759-sas2-0472-sas-l7-balancer-8080-BAL-8959&src_pof=932&lr=87",
        "image": {
          "link": "https://avatars.mds.yandex.net/i?id=a511316d5cc133c375d3529e553e0b21-5251742-images-thumbs&n=13",
          "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Favatars.mds.yandex.net%2Fi%3Fid%3Da511316d5cc133c375d3529e553e0b21-5251742-images-thumbs%26n%3D13",
          "height": 2974,
          "width": 2974
        }
      },
      {
        "title": "Картина по номерам триптих Paintboy PX 5175 Аромат кофе 3 шт. 40x50 см",
        "link": "https://market.yandex.com/product--kartina-po-nomeram-triptikh-paintboy-px-5175-aromat-kofe-3-sht-40x50-sm/818434427?utm_source_service=img&icookie=Ob4bXHskJqp%2Fawu7kmhWuwNd3JzVaUBHGJU4iHnlgNFHjHITKSHV8XiopeuQuc9advZmjm2OdlAC%2FOEpBnQknwZmJfs%3D&wprid=1661169480665375-8631934596106796759-sas2-0472-sas-l7-balancer-8080-BAL-8959&src_pof=932&lr=87",
        "image": {
          "link": "https://avatars.mds.yandex.net/i?id=f786b5227639b8ccffff03823a0bb844-4669930-images-thumbs&n=13",
          "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Favatars.mds.yandex.net%2Fi%3Fid%3Df786b5227639b8ccffff03823a0bb844-4669930-images-thumbs%26n%3D13",
          "height": 352,
          "width": 804
        }
      },
      {
        "title": "Белый Арап Карамельный кофейный напиток растворимый 3 в 1, 50 пакетиков",
        "link": "https://market.yandex.com/product--belyi-arap-karamelnyi-kofeinyi-napitok-rastvorimyi-3-v-1-50-paketikov/1416852514?utm_source_service=img&icookie=Ob4bXHskJqp%2Fawu7kmhWuwNd3JzVaUBHGJU4iHnlgNFHjHITKSHV8XiopeuQuc9advZmjm2OdlAC%2FOEpBnQknwZmJfs%3D&wprid=1661169480665375-8631934596106796759-sas2-0472-sas-l7-balancer-8080-BAL-8959&src_pof=932&lr=87",
        "image": {
          "link": "https://avatars.mds.yandex.net/i?id=ad2be167e0927d70adcf9e6f4eea11c4-4599655-images-thumbs&n=13",
          "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Favatars.mds.yandex.net%2Fi%3Fid%3Dad2be167e0927d70adcf9e6f4eea11c4-4599655-images-thumbs%26n%3D13",
          "height": 852,
          "width": 756
        }
      },
      ...
    ],
    "more_products_link": "https://yandex.com/images/search/?rpt=imageview&url=https%3A%2F%2Favatars.mds.yandex.net%2Fget-images-cbir%2F2052465%2F0LugLEh6nRjejDB3uK6Vxg9480%2Forig&cbir_id=2052465%2F0LugLEh6nRjejDB3uK6Vxg9480&cbir_page=products"
  },
  "image_tags": [
    {
      "text": "кофе чашка",
      "link": "https://yandex.com/images/search?text=%D0%BA%D0%BE%D1%84%D0%B5%20%D1%87%D0%B0%D1%88%D0%BA%D0%B0",
      "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&text=%D0%BA%D0%BE%D1%84%D0%B5+%D1%87%D0%B0%D1%88%D0%BA%D0%B0"
    },
    {
      "text": "чашечка кофе",
      "link": "https://yandex.com/images/search?text=%D1%87%D0%B0%D1%88%D0%B5%D1%87%D0%BA%D0%B0%20%D0%BA%D0%BE%D1%84%D0%B5",
      "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&text=%D1%87%D0%B0%D1%88%D0%B5%D1%87%D0%BA%D0%B0+%D0%BA%D0%BE%D1%84%D0%B5"
    },
    {
      "text": "кофе с сахаром",
      "link": "https://yandex.com/images/search?text=%D0%BA%D0%BE%D1%84%D0%B5%20%D1%81%20%D1%81%D0%B0%D1%85%D0%B0%D1%80%D0%BE%D0%BC",
      "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&text=%D0%BA%D0%BE%D1%84%D0%B5+%D1%81+%D1%81%D0%B0%D1%85%D0%B0%D1%80%D0%BE%D0%BC"
    },
    ...
  ],
  "similar_images": [
    {
      "image": {
        "link": "https://avatars.mds.yandex.net/i?id=2546ea722f368a7b4bd05a231c5b73d9-5310530-images-thumbs&n=13",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Favatars.mds.yandex.net%2Fi%3Fid%3D2546ea722f368a7b4bd05a231c5b73d9-5310530-images-thumbs%26n%3D13",
        "height": 320,
        "width": 480
      },
      "link": "https://yandex.com/images/search?url=https%3A%2F%2Favatars.mds.yandex.net%2Fget-images-cbir%2F2052465%2F0LugLEh6nRjejDB3uK6Vxg9480%2Forig&img_url=http%3A%2F%2Fimg1.goodfon.com%2Foriginal%2F5616x3744%2F2%2F1e%2Fkofe-napitok-sahar-chashka.jpg&rpt=imageview&cbir_id=2052465%2F0LugLEh6nRjejDB3uK6Vxg9480&cbir_page=similar"
    },
    {
      "image": {
        "link": "https://avatars.mds.yandex.net/i?id=fb5ae75126a49996b66b07d70e28387e-5347144-images-thumbs&n=13",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Favatars.mds.yandex.net%2Fi%3Fid%3Dfb5ae75126a49996b66b07d70e28387e-5347144-images-thumbs%26n%3D13",
        "height": 320,
        "width": 320
      },
      "link": "https://yandex.com/images/search?url=https%3A%2F%2Favatars.mds.yandex.net%2Fget-images-cbir%2F2052465%2F0LugLEh6nRjejDB3uK6Vxg9480%2Forig&img_url=http%3A%2F%2Fpsyoffice.ru%2Fuploads%2Fnews%2F18%2F2019%2F2019-09-0%2Farticle-152824-1.jpg&rpt=imageview&cbir_id=2052465%2F0LugLEh6nRjejDB3uK6Vxg9480&cbir_page=similar"
    },
    {
      "image": {
        "link": "https://avatars.mds.yandex.net/i?id=06473839e0b29dcbbbbed9558c91f2bf-5277521-images-thumbs&n=13",
        "serpapi_link": "https://serpapi.com/search.json?engine=yandex_images&url=https%3A%2F%2Favatars.mds.yandex.net%2Fi%3Fid%3D06473839e0b29dcbbbbed9558c91f2bf-5277521-images-thumbs%26n%3D13",
        "height": 320,
        "width": 240
      },
      "link": "https://yandex.com/images/search?url=https%3A%2F%2Favatars.mds.yandex.net%2Fget-images-cbir%2F2052465%2F0LugLEh6nRjejDB3uK6Vxg9480%2Forig&img_url=http%3A%2F%2Fimages.wildberries.ru%2Fbig%2Fnew%2F2160000%2F2168182-1.jpg&rpt=imageview&cbir_id=2052465%2F0LugLEh6nRjejDB3uK6Vxg9480&cbir_page=similar"
    },
    ...
  ]
}

Example results for https://i.imgur.com/xUGoFCB.jpeg

image_sizes_message will be shown when there are no matching images found.

Example results for https://i.imgur.com/xUGoFCB.jpeg

JSON Example

  {
  ...
  "image_sizes_message": "No matching images found",
  ...
}