Chapter 7. Image Service


Web search and Image search results are provided by Microsoft Coporation through the Yahoo and Microsoft Search Alliance.

Hostname Basic Example


Image Search will return a maximum of 35 results. Only the top 1000 images are returned in total.


  • You must display the title or abstract of the image when presented in the search results;
  • Display at least the first 40 characters of the referurl field which indicates the source page;
  • For the source page referurl, use the unmodified referclickurl field to navigate to the respective source page;
  • If the image is made clickable, either use unmodified refereclickurl (to the source HTML page) or clickurl (to the image) for the navigation link.

Important: You must escape reserved characters for argument values, although they are sometimes shown unescaped for readability. See Reserved Characters and Escape Values.

Optional arguments (in addition to Universal arguments)

The following arguments are specific to image search.


Values Description


yes (default) or no

Whether or not to activate the Offensive Content Reduction filter. If set to yes, content marked as offensive is omitted from results.

queryfilter -adult or -illegal

The queryfilter causes the response to be empty for a query based on the type of filter provided.

-adult - If the query is deemed to be an adult query in the provided market, then no response is returned.

-illegal - If the query is deemed to be illegal in the provided market, then no response is returned.

Note: The list of blocked queries is different in every market and is constantly being updated.


all (default), small, medium, large, wallpaper, widewallpaper

Small images are generally thumbnail or icon sized. Medium sized images are average sized; usually not exceeding an average screen size. Large images are screen size or larger. Size pairs other than those listed are ignored.


URL, no default

Search for this URL. Depending on other query restrictions, returns all image objects with this referring URL.



URL, no default

Search for this URL. Returns this exact image result.


Table of Contents