Yandex Images

Search Yandex Images, including reverse image search.

GET/api/v1/yandex/images

Costs 1 credit per request; failed requests are refunded. Authentication, the search_metadata envelope and error codes are the same as for every endpoint (see the API reference). Try it in the playground.

Parameters

Search parameters

Parameter	Type	Description
`yandex_domain`	"yandex.com" \| "yandex.ru" \| "yandex.by" \| "yandex.kz" \| "yandex.uz" \| "yandex.com.tr"	Yandex domain to search.Default: yandex.com.
`family_mode`	"0" \| "1" \| "2"	Safe search: 0 off, 1 moderate, 2 strict.Default: 1.
`p`	integer	Page number, starting at zero.Default: 0.Minimum: 0.
`text`conditional	string	Image search query; optional when url is provided.
`width`	integer	Exact image width; requires height.Minimum: 0.
`height`	integer	Exact image height; requires width.Minimum: 0.
`file_type`	"jpg" \| "png" \| "gifan"	Image file type.
`color`	"color" \| "gray" \| "red" \| "orange" \| "yellow" \| "cyan" \| "green" \| "blue" \| "violet" \| "white" \| "black"	Image color filter.
`orientation`	"horizontal" \| "vertical" \| "square"	Image orientation.
`image_type`	"photo" \| "clipart" \| "lineart" \| "demotivator" \| "face"	Image content type.
`site`	string	Limit images to this source website.
`recent`	boolean	Only images appearing in the last seven days.Default: false.
`url`conditional	string	Image URL for reverse image search.
`crop`	string	Crop coordinates: left;top;right;bottom, each between 0 and 1.
`crop_id`	string	Yandex uploaded image section ID; cannot be combined with crop.
`tab`	"about" \| "similar"	Reverse image search tab.

Response

A JSON object with search_metadata (request id, credits used and remaining) and the result data: images_results. Groups and fields depend on the content of each page, so treat every field as optional.

Examples

cURL

curl "https://serpfast.com/api/v1/yandex/images?text=coffee" \
  -H "Authorization: Bearer $SERPFAST_KEY"

Node.js 18+

const params = new URLSearchParams({
  "text": "coffee"
});
const res = await fetch(`https://serpfast.com/api/v1/yandex/images?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);

Python

import os, requests

params = {
  "text": "coffee"
}
res = requests.get(
    "https://serpfast.com/api/v1/yandex/images",
    params=params,
    headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
    timeout=120,
)
print(res.json())