Response Fields

Welcome, guest Sign In

My Projects
Tools & Services
APIs and Services
- Flickr
- Geo
- Mail
- Search
- Social
- Updates
- YAP
- YQL
Developer Tools
- Hadoop
- YUI
- YSlow
- View all »
Resources
- Blog
- YDN Theater
- Hack U

YDN Response Fields

Prev — Chapter 4. Image Search

Chapter 5. News Search — Next

Response Fields

The following is a sample XML response stub. The fields are defined in the table below:

Field descriptions
Field name	Description
`totalhits`, `deephits`	Number of listings that match the query parameters.
`abstract`	Description of image
`clickurl`	URL to click to view image
`filename`	Filename of image
`size`	Size of image file
`format`	Format of image
`height`	Height of full-size image
`date`	Last modification date of image YYYY/MM/DD
`mimetype`	MIME type of image
`refererclickurl`	Clickable link to page in which image was found
`refererurl`	Original link to page in which image was found
`title`	Title of image (usually the filename)
`url`	URL of image itself
`width`	Width of full-size image
`thumbnail_url`	Thumbnail image
`thumbnail_height`	Thumbnail height
`thumbnail_width`	Thumbnail width

Example XML Output

<ysearchresponse responsecode="200">
  <nextpage>/ysearch/images/v1/soccer?format=xml&start=10&count=10</nextpage>
  <resultset_images count="10" start="0" totalhits="4195016" deephits="4195016">
    <result>
    <abstract>Now we don't know Crawford from Adam but he's a good friend of WCP-occasional-contributor Beans and he 
              somewhat has a point, or at least made us laugh while making it.
    </abstract>
    <clickurl>http://us.lrd.yahoo.com/_ylc=X3oDMTFkNXVldGJyBGFwcGlkA2Jvc3NkZW1vBHBvcwMwBHNlcnZpY2UDWVNlYXJjaARzcmNwdmlkAw
              --/SIG=12f47a1hh/**http%3A//wickedchopspoker.blogs.com/my_weblog/images/why_men_love_soccer.jpg</clickurl>
    <filename>why_men_love_soccer.jpg</filename>
    <size>31500</size>
    <format>jpeg</format>
    <height>213</height>
    <date>2006/06/09</date>
    <mimetype>image/jpeg</mimetype>
    <refererclickurl>http://wickedchopspoker.blogs.com/my_weblog/2006/06/world_cup_musin.html</refererclickurl>
    <refererurl>http://wickedchopspoker.blogs.com/my_weblog/2006/06/world_cup_musin.html</refererurl>
    <title>why_men_love_soccer.jpg</title>
    <url>http://wickedchopspoker.blogs.com/my_weblog/images/why_men_love_soccer.jpg</url>
    <width>230</width>
    <thumbnail_height>120</thumbnail_height>
    <thumbnail_url>http://re3.yt-thm-a01.yimg.com/image/25/m7/3979077535</thumbnail_url>
    <thumbnail_width>130</thumbnail_width>
    </result>
  </resultset_images>
</ysearchresponse>

Sample Implementation

The following query searches for images about the Tour de France:

The following query searches for images about dog shows, and specifies a dimension for the results of wallpaper:

Response Fields

Example XML Output

Sample Implementation

Table of Contents