Product Search API v3

Submitting Product Search Queries

The Product Search service allows you to search the Internet for product offerings from Yahoo! Shopping. See also the Merchant Search API for merchant ratings and info, and Catalog Listing API for offers, reviews, and product specifications.

Request URL

http://shopping.yahooapis.com/ShoppingService/V3/productSearch

Summary

The Yahoo! Product Search web service lets you search for products through Yahoo! Shopping. The only required request parameters are your Yahoo! Application ID, and either a top level category name or query string. You can use YahooDemo as a sample application ID for testing. See Requesting an Application ID for information on requesting your own application ID.

You can search for items containing a specific keyword with the query parameter. The item's name and summary are searched:

http://shopping.yahooapis.com/ShoppingService/ V3/productSearch? appid=YahooDemo&query=erector

You can search for items in a specific Top Level Product Category or subcategory using the category parameter:

http://shopping.yahooapis.com/ShoppingService/ V3/productSearch? appid=YahooDemo&category=Video%20Games

The request must contain the query parameter or the category parameter, or both. If you leave off both the category and query parameters an error is returned.

Paginating Results

Your request may return a large number of items; use the results and start parameters to determine how many results you get back and from which result you want to start the display. By default, the response returns ten results, starting from result 1. The results parameter indicates how many product results to return. So, for example, to return twenty results per request, use this request:

http://shopping.yahooapis.com/ShoppingService/ V3/productSearch?appid=YahooDemo& category=Video%20Games&query=Doom&results=20

Use the start parameter to start the block of results from some result number other than 1. So, for example, the previous request returned the first 20 product results. To get the next 20 in the list, use the start parameter with the value 21:

http://shopping.yahooapis.com/ShoppingService/ V3/productSearch?appid=YahooDemo& category=Video%20Games&query=Doom&results=20&start=21

Using Refinement Keys

A list of refinement keys is returned if there are refinements to return (setting the show_narrowing parameter to 0 excludes refinements from being returned). These values can be used in subsequent requests to further narrow your search. In the request below, two Refinement keys returned are Atari items, 4168-Brand=Atari, and Nintendo items, 4168-Brand=Nintendo. We can use these two refinements, and any others returned, in a new request to limit the search. In this case, only Atari and Nintendo brand items will be searched:

http://shopping.yahooapis.com/ShoppingService/ V3/productSearch?appid=YahooDemo& category=All%20Video%20Games&query=Doom&refinement=4168-Brand=Atari&refinement=4168-Brand=Nintendo

Using Subcategories

A list of subcategories is returned if there are subcategories available (setting the show_narrowing parameter to 0 excludes subcategories from being returned). You can use these subcategories with the category parameter in subsequent requests to further narrow your search. This request yields a subcategory listing:

http://shopping.yahooapis.com/ShoppingService/V3/productSearch? appid=YahooDemo&category=All%20Video%20Games&query=Doom&results=20&

You can chose a subcategory from the response, for example, Xbox Games, to further refine your search:

http://shopping.yahooapis.com/ShoppingService/V3/productSearch? appid=YahooDemo&category=Xbox%20Games&query=Doom

By default, requests return an XML document. See Response Elements for information on the elements contained in responses.

Request parameters

See information on constructing REST queries

Parameter	Value	Description
appid	string (required)	The application ID. See Application IDs for more information.
query	string (required if category is not specified)	The query to search for.
category	string or integer (required if query is not specified)	Specifies the category to be searched. See the list of Top Level Categories available for use. To return a list of the most popular products for Computers and Electronics categories, simply submit a query using the category parameter, without specifying a keyword for the query parameter.
class	string: catalogs, freeoffers, or paidoffers default: all three types	Limits response to catalog listings (catalogs), free merchant listings (freeoffers), or paid merchant listings (paidoffers). You may also use the comma-separated list catalogs,paidoffers to return a combination of catalog and paidoffer listings.
department	integer: default is no value	Only used if the category parameter is NOT specified. The specific department of Yahoo! Shopping to search. See Supported Department Codes.
highestprice	floating point number: default is no value	The maximum price for returned items (in US dollars).
lowestprice	floating point number: default is no value	The minimum price for returned items (in US dollars).
merchantid	integer: default is no value	If specified, the service will return only results offered by that merchant. The argument will be ignored if a non-numeric category (not beginning with 1can1) is specified.
refinement	string	Used only if category is specified. Category used should be from the Category element returned in the RefineValue node. Multiple refinement keys having the same category can be specified. eg: &refinement=4354-Brand=Dell&refinement=1234-Store=CompUsa
results	integer: 1-50 default value is 10	The number of results to return.
show_numratings	boolean: 0 or 1 default is 0	When set to 1, returns the number of ratings for each product (if available). Caution: If set to 1, it will result in increased response time for your request.
show_narrowing	0 or 1 (default is 1)	Set to 0 to exclude subcategory or refinement-narrowing options from results.
sort	string: price_ascending, price_descending, userrating_ascending, or userrating_descending	By default, results are sorted by relevance. The sort argument gives you the option of sorting by price or user rating. To sort by user rating, you must specify a category that is non-numeric and not beginning with 1can1.
start	integer: 1-300 default value is 1	The starting result position to return. The starting position cannot exceed 300.
output	xml (default), php, json	The format for the output. If output=json, the results will be returned in JSON format. If output=php, the results will be returned in Serialized PHP format.
callback	string: default no value	The name of the callback function to wrap around the JSON data. The following characters are allowed: A-Z a-z 0-9. [] and _. If output=json has not been requested, this parameter has no effect. More information on the callback can be found in the Yahoo! Developer Network JSON Documentation.

Sample Request Urls:

• Search in category Computer Accessories with Refinements:
  http://shopping.yahooapis.com/ShoppingService/v3/productSearch?appid=YahooDemo&category=
  Computer%20Accessories&refinement=4168-Brand=HP
• Search for query digital camera:
  http://shopping.yahooapis.com/ShoppingService/v3/productSearch?appid=YahooDemo&query=
  digital+camera&show_numratings=1
• Search for football pants in the category Clothing with Refinements:
  http://shopping.yahooapis.com/ShoppingService/v3/productSearch? appid=YahooDemo&category=
  Clothing&query=football+pants& refinement=4168-Brand=Calvin%20Klein
• Search for query harry potter with Sub-Categories returned:
  http://shopping.yahooapis.com/ShoppingService/v3/productSearch?appid=YahooDemo&query=
  harry+potter
  
• Search for query harry potter with output returned in php:
  http://shopping.yahooapis.com/ShoppingService/v3/productSearch?appid=YahooDemo&query=
  harry+potter&output=php
  
• Search for query ipod with output returned in JSON:
  http://shopping.yahooapis.com/ShoppingService/v3/productSearch?appid=YahooDemo&query=
  harry+potter&output=json

Response Elements

The Yahoo! Shopping Product Search REST response conforms to XML 1.0. The schema document for this response is located at http://shopping.yahooapis.com/shoppingservice/v3/productsearch.xsd

Top-Level Elements

Element	Description
ProductSearch	Top level container for all responses.
Categories	Container for element SubCategory. Contains a list of subcategories. Returned only if subcategories are available (setting show_narrowing parameter to 0 will exclude subcategories from being returned). Details of each subcategory are provided below. Attributes: total_subcategories: integer indicating total subcategories returned. type: when type=can it is recommended to display subcategories below refinements.
Refinements	Container for element Refinement. Returned only if there are available Refinements to return (setting show_narrowing parameter to 0 excludes refinements from being returned). Attributes: name: An attribute specifying the display name for the refinement key. totalvalues: An attribute specifying the number of values returned for this refinement key. totalAvailable: An attribute specifying the total number of values available for this refinement key. This attribute is set when the number of refinement values returned is less than the number of refinement values available for the refinement group. The last refinement value is More and its value can be used with the refinement flag to get more refinement values for this refinement group
Products	Container for element Product Contains each individual product offering. (list of Product elements). Each Product element contains either a Catalog or an Offer element, and has an attribute named type to indicate whether the enclosed element is a Catalog or an Offer element. Attributes: totalResultsAvailable: The number of query matches in the database. totalResultsReturned: The number of query matches returned. This may be lower than the number of results requested if there were fewer total results available. firstResultPosition: The position of the first result in the overall search. spellSuggestion: Returned when common spelling mistakes are detected in the query (i.e. digital camrea, which would prompt a suggested query of digital camera). relatedSearches: This is a comma separated string of terms related to the query e.g. ipod mini,mini ipod,apple ipod,apple ipod mini,ipod 20gb for query=ipod . This attribute will appear if there are available related searches to return.

SubCategory Elements

Element	Description
Title	Contains the display name for the subcategory.
NumberOfProducts	Contains the number of products available for this subcategory
Value	Contains the value for the subcategory that can be used as a value for the category request parameter. The value returned can be either numeric or non-numeric. (Numeric values signify departments, while non-numeric values signify subcategories.)
SubCategory	Contains nested subcategories. Returned only if nested subcategories are available. Each SubCategory element has elements listed in this table.

RefineValue Elements

Each Refinement element contains a list of RefineValue elements. Each RefineValue element may contain the following elements:

Element	Description
Title	Contains the display name for the Refinement.
NumberOfProducts	Contains the number of products available for this Refinement.
Value	Contains the value for the Refinement that can be used as a value for the refinement request parameter.
Category	Contains the category, that should be used as a value for the category parameter in the API's URL, for this refinement to be applied.

Catalog Elements

The Catalog elements describe an item.

Element	Description
AverageRating	A value from 1 (worst) to 5 (best) representing the average rating given to this product by a user.
Brand	Contains the brand name of the product.
Catalog	Contains the data for a Yahoo! Shopping Offer merchant comparison grid. Has the attribute ID for this catalog, which you can use to compare prices with the CatalogID parameter.
Category	Contains the value for the catgory that the product belongs to.
CreateRatingUrl	The Url to the page for posting reviews of this product on Yahoo! Shopping.
Department	Contains the value for the department that the product belongs to. Has the attribute ID for this department, which you can use to get other products from the same department using the department parameter in the ProductSearch API.
Description	A longer description of the product.
GridImage	Contains an image described by GridImage elements.
ListImage	Contains an image described by ListImage elements.
MaxRating	A value from 1 (worst) to 5 (best) representing the maximum rating given to this product by a user.
Model	Contains the value for Model of the product.
NumOfStores	Contains the value for number of stores offering the product.
NumRatings	The number of users who have rated this product.
Part Number	Contains the value for the Manufacturer Part Number of the product.
PriceFrom	The lowest price (in US dollars) for the product in this catalog.
PriceTo	The highest price (in US dollars) for the product in this catalog.
ProductName	The name of the product.
RatingUrl	The Url to the ratings page for this product on Yahoo! Shopping.
SpecificationList	Contains a list of Specification elements
Summary	A short description of the product.
Thumbnail	Contains an image described by Thumbnail elements
UPC	Contains the value for UPC/ISBN number of the product.
Url	The URL for the corresponding catalog page on Yahoo! Shopping.
UserRating	Contains the user rating information for this item.

Offer Elements

Element	Description
Average Rating	A value from 1(worst) to 5 (best) representing the average rating given to this merchant by a user.
Category	Contains the value for the category that the product belongs to.
Department	Contains the value for department that the product belongs to. Has the attribute ID for this department, which you can use to get other products from the same department using the department parameter in the ProductSearch API.
GridImage	Contains an image described by GridImage elements.
ListImage	Contains an image described by ListImage elements.
MaxRating	A value from 1 (worst) to 5 (best) representing the maximum rating given to this merchant by a user.
Merchant	An enclosing tag for information about the merchant making this offer. Has the attribute ID for this merchant, which you can use in Merchant Search.
Name	Contains value for name of the merchant.
Offer	Contains the data for an individual merchant offering of a product.
Price	Price of the product in US dollars.
ProductName	The name of the product.
RatingUrl	The Url to the ratings page for this merchant on Yahoo! Shopping.
Summary	A short description of the product.
Thumbnail	Contains an image described by Thumbnail elements.
URL	The URL for the product page on the merchant site.

GridImage, ListImage, and Thumbnail Elements

GridImage, ListImage, and Thumbnail elements contain the details of an image.

Element	Description
URL	The URL link to the image.
Height	The height of the image in pixels.
Width	The width of the image in pixels.

UserRating Elements

Element	Description
AverageRating	The average rating of the item.
CreateRatingUrl	A URL to the page to add ratings for the item.
MaxRating	The highest rating for the item.
NumRating	The total number of ratings for the item.
RatingUrl	A URL to the ratings section of the item.

Specification Elements

Element	Description
SpecificationLabel	The name of a specification for an item. For example: Cable Type
SpecificationValue	The value corresponding to SpecificationLabel. For example: Power Adapter

Sample response

The following is a sample response for query=dell with category=Computers

<?xml version="1.0" encoding="utf-8"?> <ProductSearch xmlns="urn:yahoo:prods" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:yahoo:prods http://shopping.yahooapis.com/shoppingservice/v3/productsearch.xsd"> <Categories totalSubcategories="3"> <SubCategory> <Title>Desktops</Title> <Value>Desktops</Value> <NumberOfProducts>128</NumberOfProducts> </SubCategory> <SubCategory> <Title>Laptops</Title> <Value>Laptops</Value> <NumberOfProducts>87</NumberOfProducts> </SubCategory> <SubCategory> <Title>More Computer Systems</Title> <Value>More%20Computer%20Systems</Value> <NumberOfProducts>1</NumberOfProducts> </SubCategory> </Categories> <Refinements> <Refinement name="Store" totalAvailable="13" totalValues="11"> <RefineValue> <Title>TigerDirect.com</Title> <Value>4491-Store=1016931</Value> <Category>Computers</Category> <NumberOfProducts>15</NumberOfProducts> </RefineValue> <RefineValue> <Title>Overstock.com</Title> <Value>4491-Store=1000264</Value> <Category>Computers</Category> <NumberOfProducts>30</NumberOfProducts> </RefineValue> <RefineValue> <Title>megasystemsltd</Title> <Value>4491-Store=1008117</Value> <Category>Computers</Category> <NumberOfProducts>17</NumberOfProducts> </RefineValue> <RefineValue> <Title>pcexchange-net</Title> <Value>4491-Store=1016037</Value> <Category>Computers</Category> <NumberOfProducts>12</NumberOfProducts> </RefineValue> <RefineValue> <Title>LaptopOutlet</Title> <Value>4491-Store=1012292</Value> <Category>Computers</Category> <NumberOfProducts>8</NumberOfProducts> </RefineValue> <RefineValue> <Title>Geeks.com</Title> <Value>4491-Store=1025954</Value> <Category>Computers</Category> <NumberOfProducts>7</NumberOfProducts> </RefineValue> <RefineValue> <Title>Heartland America</Title> <Value>4491-Store=1035570</Value> <Category>Computers</Category> <NumberOfProducts>4</NumberOfProducts> </RefineValue> <RefineValue> <Title>Usanotebook.com</Title> <Value>4491-Store=1018835</Value> <Category>Computers</Category> <NumberOfProducts>3</NumberOfProducts> </RefineValue> <RefineValue> <Title>Microjendeals</Title> <Value>4491-Store=1052422</Value> <Category>Computers</Category> <NumberOfProducts>2</NumberOfProducts> </RefineValue> <RefineValue> <Title>CompuVest On-line</Title> <Value>4491-Store=1007411</Value> <Category>Computers</Category> <NumberOfProducts>2</NumberOfProducts> </RefineValue> <RefineValue> <Title>More ...</Title> <Value>more=s4491</Value> <Category>Computers</Category> </RefineValue> </Refinement> <Refinement name="Sales & Deals" totalValues="5"> <RefineValue> <Title>10% Off &amp; More</Title> <Value>4492-Sales%20%26%20Deals=10%25%20Off%20%26%20More</Value> <Category>Computers</Category> <NumberOfProducts>70</NumberOfProducts> </RefineValue> <RefineValue> <Title>25% Off &amp; More</Title> <Value>4492-Sales%20%26%20Deals=25%25%20Off%20%26%20More</Value> <Category>Computers</Category> <NumberOfProducts>63</NumberOfProducts> </RefineValue> <RefineValue> <Title>50% Off &amp; More</Title> <Value>4492-Sales%20%26%20Deals=50%25%20Off%20%26%20More</Value> <Category>Computers</Category> <NumberOfProducts>10</NumberOfProducts> </RefineValue> <RefineValue> <Title>All Sale Items</Title> <Value>4492-Sales%20%26%20Deals=All%20Sale%20Items</Value> <Category>Computers</Category> <NumberOfProducts>70</NumberOfProducts> </RefineValue> <RefineValue> <Title>Free Shipping</Title> <Value>4492-Sales%20%26%20Deals=Free%20Shipping</Value> <Category>Computers</Category> <NumberOfProducts>1</NumberOfProducts> </RefineValue> </Refinement> </Refinements> <Products firstResultPosition="1" totalResultsAvailable="216" totalResultsReturned="5"> <Product type="Offer"> <Offer ID="10460423"> <Url>http://www.overstock.com/cgi-bin/d2.cgi?PAGE=PRODUCT&PROD_ID=2191681&cid=80208&fp=F</Url> <ProductName>USED <b>Dell</b> Latitude C640 2.0GHz PIV w/DVD/CDRW Laptop</ProductName> <Price>591.99</Price> <Thumbnail> <Url>http://f3c.yahoofs.com/shopping/mcid2_89385/simg_t_t10460423t10460423jpg70?rm_____Dajb..fqx</Url> <Height>70</Height> <Width>70</Width> </Thumbnail> <ListImage> <Url>http://f3c.yahoofs.com/shopping/mcid2_89385/simg_t_t10460423t10460423jpg85?rm_____DWBbOnDpX</Url> <Height>85</Height> <Width>85</Width> </ListImage> <GridImage> <Url>http://f3c.yahoofs.com/shopping/mcid2_89385/simg_t_t10460423t10460423jpg110?rm_____DEhwybZn8</Url> <Height>110</Height> <Width>110</Width> </GridImage> <Summary>Display: 14.1-inch TFT LCD Processor: 2.0GHz Pentium 4 System memory: 512MB Hard drive: 30GB Optical drive: DVD/CD-RW combo</Summary> <Merchant id="1000264"> <Name>Overstock.com</Name> <MaxRating>5</MaxRating> <AverageRating>3</AverageRating> <RatingUrl>http://shopping.yahoo.com/merchrating/user_rv.html?merchant_id=1000264</RatingUrl> </Merchant> <Category> <Title>Laptops</Title> <Value>Laptops</Value> </Category> </Offer> </Product> <Product type="Offer"> <Offer ID="2265736"> <Url>http://www.tigerdirect.com/applications/searchtools/item-details.asp?EdpNo=2265736&Sku=J156-4044&SRCCODE=YAHOODF&CMP=SPC-YAHOO</Url> <ProductName><b>Dell</b> Latitude C640 Refubished Off-Lease Laptop - Intel Pentium 4 2.0GHz, 256MB DDR, 20GB HDD, CD ROM, 14.1 XGA, Windows XP Home</ProductName> <Price>489.97</Price> <Thumbnail> <Url>http://f3c.yahoofs.com/shopping/mcid8_51008/simg_t_t2265736j1563066mainjpg70?rm_____DtNIVWLP_</Url> <Height>70</Height> <Width>70</Width> </Thumbnail> <ListImage> <Url>http://f3c.yahoofs.com/shopping/mcid8_51008/simg_t_t2265736j1563066mainjpg85?rm_____DnXrAa93p</Url> <Height>85</Height> <Width>85</Width> </ListImage> <GridImage> <Url>http://f3c.yahoofs.com/shopping/mcid8_51008/simg_t_t2265736j1563066mainjpg110?rm_____DF8H1YORV</Url> <Height>110</Height> <Width>110</Width> </GridImage> <Summary><b>Dell</b> Latitude notebooks meet the varying needs of business and institutional customers - needs that include powerful performance and portability.</Summary> <Merchant id="1016931"> <Name>TigerDirect.com</Name> <MaxRating>5</MaxRating> <AverageRating>4</AverageRating> <RatingUrl>http://shopping.yahoo.com/merchrating/user_rv.html?merchant_id=1016931</RatingUrl> </Merchant> <Department ID="57"> <Name>Computers & Office</Name> </Department> <Category> <Title>Laptops</Title> <Value>Laptops</Value> </Category> </Offer> </Product> <Product type="Offer"> <Offer ID="10441066"> <Url>http://www.overstock.com/cgi-bin/d2.cgi?PAGE=PRODUCT&PROD_ID=2166765&cid=80208&fp=F</Url> <ProductName>Used <b>Dell</b> Latitude D600 1.4GHz Pentium M w/DVD Laptop</ProductName> <Price>569.99</Price> <Thumbnail> <Url>http://f3c.yahoofs.com/shopping/mcid13_139650/simg_t_t10441066t10332742jpg70?rm_____D4QcfL0PF</Url> <Height>70</Height> <Width>70</Width> </Thumbnail> <ListImage> <Url>http://f3c.yahoofs.com/shopping/mcid13_139650/simg_t_t10441066t10332742jpg85?rm_____Dvz1296ks</Url> <Height>85</Height> <Width>85</Width> </ListImage> <GridImage> <Url>http://f3c.yahoofs.com/shopping/mcid13_139650/simg_t_t10441066t10332742jpg110?rm_____DkTapVvWt</Url> <Height>110</Height> <Width>110</Width> </GridImage> <Summary>Fueled by a blazing 1.4GHz Pentium M processor, the <b>Dell</b> D600 notebook computer easily handles all your files and applications whether at home or at the office.</Summary> <Merchant id="1000264"> <Name>Overstock.com</Name> <MaxRating>5</MaxRating> <AverageRating>3</AverageRating> <RatingUrl>http://shopping.yahoo.com/merchrating/user_rv.html?merchant_id=1000264</RatingUrl> </Merchant> <Category> <Title>Laptops</Title> <Value>Laptops</Value> </Category> </Offer> </Product> <Product type="Catalog"> <Catalog ID="1992970879"> <Url>http://shopping.yahoo.com/p:Dell%20XPS%20M170%20:1992970879</Url> <ProductName><b>Dell</b> XPS M170 Laptop Computer</ProductName> <PriceFrom>700.00</PriceFrom> <PriceTo>1139.18</PriceTo> <Thumbnail> <Url>http://f3c.yahoofs.com/shopping/3030153/simg_t_txpsm170_front_145x145jpg85?rm_____D5qrivDiX</Url> <Height>85</Height> <Width>85</Width> </Thumbnail> <ListImage> <Url>http://f3c.yahoofs.com/shopping/3030153/simg_t_txpsm170_front_145x145jpg85?rm_____D5qrivDiX</Url> <Height>85</Height> <Width>85</Width> </ListImage> <GridImage> <Url>http://f3c.yahoofs.com/shopping/3030153/simg_t_txpsm170_front_145x145jpg110?rm_____DttqnLOBb</Url> <Height>110</Height> <Width>110</Width> </GridImage> <Description>Dell XPS M170 is a powerful and bold desktop replacement notebook. The XPS M170 takes advantage of Intel's Pentium M high performance and energy efficient processors to offer the best combination of processing power, weight and battery endurance. The 17" Wide Screen UXGA with TrueLife provides a vivid, high resolution viewing experience whether you are surfing, watching a DVD or dominating your gaming opponents. Created for the power user who demands uncompromising performance, the XPS M170 brings notebook computing to a whole new level.</Description> <Summary> Dell - Intel - Pentium M - 2.13 GHz Processor - 1 GB Memory - 60 GB Hard Drive </Summary> <UserRating> <MaxRating>5</MaxRating> <AverageRating>4.57</AverageRating> <RatingUrl>http://shopping.yahoo.com/p:Dell%20XPS%20M170%20:1992970879:page=user-reviews</RatingUrl> <CreateRatingUrl>http://shopping.yahoo.com/p:Dell%20XPS%20M170%20:1992970879:page=post-reviews</CreateRatingUrl> </UserRating> <SpecificationList> <Specification> <SpecificationLabel>Processor Brand</SpecificationLabel> <SpecificationValue>Intel</SpecificationValue> </Specification> <Specification> <SpecificationLabel>Processor Class</SpecificationLabel> <SpecificationValue>Pentium M</SpecificationValue> </Specification> <Specification> <SpecificationLabel>Processor Speed</SpecificationLabel> <SpecificationValue>2.13 GHz</SpecificationValue> </Specification> <Specification> <SpecificationLabel>Installed Memory</SpecificationLabel> <SpecificationValue>1 GB</SpecificationValue> </Specification> <Specification> <SpecificationLabel>Hard Drive Capacity</SpecificationLabel> <SpecificationValue>60 GB</SpecificationValue> </Specification> <Specification> <SpecificationLabel>Operating System</SpecificationLabel> <SpecificationValue>Microsoft Windows XP Media Center</SpecificationValue> </Specification> <Specification> <SpecificationLabel>Weight</SpecificationLabel> <SpecificationValue>8.6 lbs</SpecificationValue> </Specification> </SpecificationList> <Department ID="57"> <Name>Computers & Office</Name> </Department> <Category> <Title>Laptops</Title> <Value>Laptops</Value> </Category> <Brand>Dell</Brand> <Model>XPSM170</Model> <PartNumber>XPSM170Notebook XPSM-170Notebook XPSM170-Notebook XPSM-170-Notebook XP-S M170 Notebook XPS- M170 Notebook XPS M170 Noteboo-k IMX170S2 IMX-170S2 IMX170-S2 IMX-170-S2 IMX170S-2 IMX-170S-2 IMX170-S-2 IMX-170-S-2 IM-X170S2</PartNumber> <NumOfStores>3</NumOfStores> </Catalog> </Product> <Product type="Offer"> <Offer ID="10482588"> <Url>http://www.overstock.com/cgi-bin/d2.cgi?PAGE=PRODUCT&PROD_ID=2218704&cid=80208&fp=F</Url> <ProductName><b>Dell</b> D600 Centrino 1.6GHz Laptop w/DVD/CDRW</ProductName> <Price>699.99</Price> <Thumbnail> <Url>http://f3c.yahoofs.com/shopping/mcid1_287442/simg_t_t10482588t10482588jpg70?rm_____DtBz2dqrZ</Url> <Height>70</Height> <Width>70</Width> </Thumbnail> <ListImage> <Url>http://f3c.yahoofs.com/shopping/mcid1_287442/simg_t_t10482588t10482588jpg85?rm_____DaQEPV.Ub</Url> <Height>85</Height> <Width>85</Width> </ListImage> <GridImage> <Url>http://f3c.yahoofs.com/shopping/mcid1_287442/simg_t_t10482588t10482588jpg110?rm_____DtjlsScMA</Url> <Height>110</Height> <Width>110</Width> </GridImage> <Summary>Display: 14.1-inch TFT Processor: 1.0 GHz Pentium III System memory: 256MB</Summary> <Merchant id="1000264"> <Name>Overstock.com</Name> <MaxRating>5</MaxRating> <AverageRating>3</AverageRating> <RatingUrl>http://shopping.yahoo.com/merchrating/user_rv.html?merchant_id=1000264</RatingUrl> </Merchant> <Category> <Title>Laptops</Title> <Value>Laptops</Value> </Category> </Offer> </Product> </Products> </ProductSearch>

Errors

The Product Search service returns the standard errors. A 999 error is returned if the query limit has been exceeded.

Related Information

Rate Limits

The Product Search service is a part of the Yahoo! Shopping Web Services, which are limited to 5,000 queries per appid per day. See information on rate limiting.

Terms of Use

When calling the shopping APIs, you must set the HTTP user agent to a valid web browser string. Bot and spider strings are not valid. The user agent can be set to some default value - it does not have to be changed based on the user's browser. Some examples are as follows:

• Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1) (for IE)
• Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.0.1) Gecko/20060111 Firefox/1.5.0.1 (for FireFox)

If a valid user agent is not set, no results will be returned. A 400 HTTP status code will be returned, along with an error message indicating that the user agent is not valid.

More information on user agents can be found at http://en.wikipedia.org/wiki/user_agent.

For all Web sites and applications that present data from the Yahoo! Shopping API, the attribution text "Powered by Yahoo! Shopping" must be presented. You may link the attribution text back to the Yahoo! Shopping site.

Support & Community

The Product Search service is discussed on the yws-shopping mailing list.