web_image_search
Search for images by keyword and return direct image file URLs with source page details.
Instructions
Image search through our own metasearch layer. The third tool of the module: web_search finds pages, web_read extracts their content, this one finds IMAGES.
WHEN TO CALL. You need a picture of an object, a product, a building, a person, a diagram. You need the address of the image file itself rather than of a page about it.
WHEN NOT TO CALL. You need text about the object — that is web_search. You need the content of a specific page — web_read. This tool does NOT look at the pictures and does not describe them: it finds addresses, and whoever can see looks at them.
WHAT IT RETURNS. results[] with image_url (the file itself), page_url (the page it was found on), domain (the site the image is SOURCED from), page_domain, thumbnail, title, author, published, via.
HOW TO READ THE ANSWER — three things.
AN IMAGE HAS TWO ADDRESSES and they must not be confused: image_url is the file, page_url is the page. Showing the page instead of the image is a mistake only a human notices.
AN EMPTY LIST IS A SUCCESS, not a failure: we looked and found nothing. A failure arrives with ok=false and a reason.
engines_irrelevant names engines whose results were discarded ENTIRELY as not being about the query. With images this is common: an engine returns its own catalogue regardless of the query and looks excellent by result count.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | the result page, from zero; default 0 | |
| query | Yes | what to look for; a non-Latin script switches the results to that language | |
| max_results | No | how many images to return, default 12 |