Chapter 7. Image Service

Note

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

Hostname Basic Example

Note

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

Requirements:

  • 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.

Parameter

Values Description

filter

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.

dimensions

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.

refererurl

URL, no default

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

Example: http://www.foo.com/~foo/images.htm

url

URL, no default

Search for this URL. Returns this exact image result.

Example: http://www.foo.com/~foo/images/mydog.gif

Table of Contents