JSON POST request example
POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/yandex/images with Content-Type: application/json and your Authorization: Bearer header.
{
"text": "coffee"
}// request reference
Yandex Images parameters
Send query parameters with GET /api/yandex/images. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Search parameters
yandex_domainYandex domain to search.
Type string · GET query or POST JSON · Default yandex.com
yandex.comyandex.ruyandex.byyandex.kzyandex.uzyandex.com.trfamily_modeSafe search: 0 off, 1 moderate, 2 strict.
Type integer · GET query or POST JSON · Default 1
012pPage number, starting at zero.
Type integer · GET query or POST JSON · Default 0
- Minimum: 0
textImage search query; optional when url is provided.
Type string · GET query or POST JSON
- Minimum characters: 1
widthExact image width; requires height.
Type integer · GET query or POST JSON
- Greater than: 0
heightExact image height; requires width.
Type integer · GET query or POST JSON
- Greater than: 0
file_typeImage file type.
Type string · GET query or POST JSON
jpgpnggifancolorImage color filter.
Type string · GET query or POST JSON
colorgrayredorangeyellowcyangreenbluevioletwhiteblackorientationImage orientation.
Type string · GET query or POST JSON
horizontalverticalsquareimage_typeImage content type.
Type string · GET query or POST JSON
photoclipartlineartdemotivatorfacesiteLimit images to this source website.
Type string · GET query or POST JSON
recentOnly images appearing in the last seven days.
Type boolean · GET query or POST JSON · Default false
truefalseurlImage URL for reverse image search.
Type string · GET query or POST JSON
cropCrop coordinates: left;top;right;bottom, each between 0 and 1.
Type string · GET query or POST JSON
crop_idYandex uploaded image section ID; cannot be combined with crop.
Type string · GET query or POST JSON
tabReverse image search tab.
Type string · GET query or POST JSON
aboutsimilar// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include search_metadata, search_parameters, search_information, organic_results, ads, images_results, suggested_searches, image_results, similar_images, sites, image_sizes, pagination, litescrape_pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.
Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.