Content API - Merchandise

Back to Content API Overview

These APIs can be used to pull the list of all Merchandise supported by CafePress and the details of each type of Merchandise. The details provided are primarly needed to
A) design the Merchandise ( e.g. you can design for the front center,the printable area is 10 inches tall X 10 inches wide and the DPI should at least be 100) and
B) for Merchandising (description, price, etc.).

Some of the Merchandise listed by merchandise.list.cp cannot be designed using the Product APIs yet. These are Fulfillment, Books, CDs, and All Dark apparel.

merchandise.getExample.cp

This is a demo API that demonstrates the details available for Merchandise.The example API gets the details of Product ID = 1 (i.e. a Mug).

Signature

merchandise.getExample.cp

Parameters

None

Response

<?xml version="1.0" ?> 
- <merchandise id="1" name="Mug" parent-id="0">
  <features /> 
  <constraints /> 
  <documentFeatureWrappers /> 
- <canvases>
- <canvas name="FrontCenter" units="inches">
  <height>3</height> 
  <width>8.3125</width> 
  <minimum-dpi>200</minimum-dpi> 
  </canvas>
- <canvas name="BackCenter" units="inches">
  <height>3</height> 
  <width>8.3125</width> 
  <minimum-dpi>200</minimum-dpi> 
  </canvas>
  </canvases>
- <properties>
  <int name="LegacyProductTypeId" value="0" /> 
  <price name="BasePrice" value="10.99" /> 
  <string name="CategoryCaption" value="Housewares" /> 
  <string name="CategoryId" value="5" /> 
  <string name="DefaultColor" value="N/A" /> 
  <string name="DefaultOrientation" value="Normal" /> 
  <string name="DefaultPerspective" value="Front" /> 
  <string name="DefaultSize" value="N/A" /> 
  <string name="Description" value="Mug" /> 
  <string name="MerchandiseAvailability" value="All Stores | Permanent Item" /> 
  <string name="MerchandiseAvailabilityStatusId" value="3" /> 
  <string name="ShortCaption" value="Mug" /> 
  <string name="ShortDescription" value="Mug" /> 
  <string name="StockAvailability" value="In Stock, will ship in 2 business days" /> 
  <string name="StockAvailablilityStatusId" value="1" /> 
  </properties>
  </merchandise>

Errors

Standard Errors as described here

Example

http://api.cafepress.com/merchandise.getExample.cp

merchandise.list.cp

Get the list of ALL Merchandise supported by Cafepress.

Signature

merchandise.list.cp

Parameters

None

Response

<?xml version="1.0" ?> 
- <merchandise-collection>
- <merchandise id="1" name="Mug" parent-id="0">
  <features /> 
  <constraints /> 
  <documentFeatureWrappers /> 
- <canvases>
- <canvas name="FrontCenter" units="inches">
  <height>3</height> 
  <width>8.3125</width> 
  <minimum-dpi>200</minimum-dpi> 
  </canvas>
- <canvas name="BackCenter" units="inches">
  <height>3</height> 
  <width>8.3125</width> 
  <minimum-dpi>200</minimum-dpi> 
  </canvas>
  </canvases>
- <properties>
  <int name="LegacyProductTypeId" value="0" /> 
  <price name="BasePrice" value="10.99" /> 
  <string name="CategoryCaption" value="Housewares" /> 
  <string name="CategoryId" value="5" /> 
  <string name="DefaultColor" value="N/A" /> 
  <string name="DefaultOrientation" value="Normal" /> 
  <string name="DefaultPerspective" value="Front" /> 
  <string name="DefaultSize" value="N/A" /> 
  <string name="Description" value="Mug" /> 
  <string name="MerchandiseAvailability" value="All Stores | Permanent Item" /> 
  <string name="MerchandiseAvailabilityStatusId" value="3" /> 
  <string name="ShortCaption" value="Mug" /> 
  <string name="ShortDescription" value="Mug" /> 
  <string name="StockAvailability" value="In Stock, will ship in 2 business days" /> 
  <string name="StockAvailablilityStatusId" value="1" /> 
  </properties>
  </merchandise>
+ <merchandise id="2" name="Large Mug" parent-id="0">
+ <merchandise id="3" name="White T-Shirt" parent-id="0">
+ <merchandise id="4" name="Mousepad" parent-id="0">
+ <merchandise id="7" name="Jr. Baby Doll T-Shirt" parent-id="0">
+ <merchandise id="9" name="Fulfillment" parent-id="0">
+ <merchandise id="11" name="Boxer Shorts" parent-id="0">
+ <merchandise id="12" name="Messenger Bag" parent-id="0">
+ <merchandise id="13" name="Hooded Sweatshirt" parent-id="0">
+ <merchandise id="14" name="Teddy Bear" parent-id="0">
+ <merchandise id="15" name="Tile Coaster" parent-id="0">
+ <merchandise id="16" name="Baseball Jersey" parent-id="0">
+ <merchandise id="17" name="BBQ Apron" parent-id="0">
+ <merchandise id="18" name="Golf Shirt" parent-id="0">
+ <merchandise id="19" name="Wall Clock" parent-id="0">
+ <merchandise id="20" name="Sticker (Rectangular)" parent-id="0">
+ <merchandise id="21" name="Sticker (Oval)" parent-id="0">
+ <merchandise id="22" name="License Plate Frame" parent-id="0">
+ <merchandise id="23" name="Small Poster" parent-id="0">
+ <merchandise id="24" name="Large Poster" parent-id="0">
+ <merchandise id="25" name="Small Framed Print" parent-id="0">
+ <merchandise id="26" name="Large Framed Print" parent-id="0">
+ <merchandise id="27" name="Black Cap" parent-id="0">
+ <merchandise id="28" name="Infant/Toddler T-Shirt" parent-id="0">
+ <merchandise id="29" name="Kids T-Shirt" parent-id="0">
+ <merchandise id="30" name="Infant Bodysuit" parent-id="0">
+ <merchandise id="31" name="Bib" parent-id="0">
+ <merchandise id="32" name="Calendar Print" parent-id="0">
+ <merchandise id="33" name="Wall Calendar" parent-id="0">
+ <merchandise id="34" name="Postcards (Package of 8)" parent-id="0">
+ <merchandise id="35" name="Greeting Cards (Package of 6)" parent-id="0">
+ <merchandise id="36" name="Classic Thong" parent-id="0">
+ <merchandise id="37" name="Framed Panel Print" parent-id="0">
+ <merchandise id="38" name="Tile Box" parent-id="0">
+ <merchandise id="39" name="Camisole" parent-id="0">
+ <merchandise id="40" name="Women's T-Shirt" parent-id="0">
+ <merchandise id="41" name="Sticker (Bumper)" parent-id="0">
+ <merchandise id="42" name="Mini Poster Print" parent-id="0">
+ <merchandise id="43" name="Audio CD" parent-id="0">
+ <merchandise id="44" name="Data CD" parent-id="0">
+ <merchandise id="45" name="Jr. Spaghetti Tank" parent-id="0">
+ <merchandise id="46" name="Book" parent-id="0">
+ <merchandise id="47" name="Journal" parent-id="0">
+ <merchandise id="48" name="Trucker Hat" parent-id="0">
+ <merchandise id="49" name="Jr. Raglan" parent-id="0">
+ <merchandise id="50" name="Jr. Hoodie" parent-id="0">
+ <merchandise id="51" name="Ornament (Oval)" parent-id="0">
+ <merchandise id="52" name="Fitted T-Shirt" parent-id="0">
+ <merchandise id="53" name="Yellow T-Shirt" parent-id="0">
+ <merchandise id="54" name="Green T-Shirt" parent-id="0">
+ <merchandise id="55" name="Women's Pink T-Shirt" parent-id="0">
+ <merchandise id="56" name="Dog T-Shirt" parent-id="0">
+ <merchandise id="57" name="Organic Cotton Tee" parent-id="0">
+ <merchandise id="58" name="Value T-shirt" parent-id="0">
+ <merchandise id="59" name="Jr. Ringer T-Shirt" parent-id="0">
+ <merchandise id="60" name="Women's Tank Top" parent-id="0">
+ <merchandise id="61" name="Men's Sleeveless Tee" parent-id="0">
+ <merchandise id="62" name="Button" parent-id="0">
+ <merchandise id="63" name="Magnet" parent-id="0">
+ <merchandise id="64" name="2.25" Button (10 pack)" parent-id="0">
+ <merchandise id="65" name="2.25" Button (100 pack)" parent-id="0">
+ <merchandise id="66" name="2.25" Magnet (10 pack)" parent-id="0">
+ <merchandise id="67" name="2.25" Magnet (100 pack)" parent-id="0">
+ <merchandise id="68" name="Ornament (Round)" parent-id="0">
+ <merchandise id="69" name="Throw Pillow" parent-id="0">
+ <merchandise id="70" name="Ringer T" parent-id="0">
+ <merchandise id="71" name="Women's Raglan Hoodie" parent-id="0">
+ <merchandise id="72" name="Women's Tracksuit" parent-id="0">
+ <merchandise id="73" name="Custom Postage" parent-id="0">
+ <merchandise id="74" name="Light Switch Cover" parent-id="0">
+ <merchandise id="75" name="Kids Hoodie" parent-id="0">
+ <merchandise id="76" name="Women's Cap Sleeve T-Shirt" parent-id="0">
+ <merchandise id="77" name="Kids Sweatshirt" parent-id="0">
+ <merchandise id="78" name="Kids Baseball Jersey" parent-id="0">
+ <merchandise id="79" name="Rectangle Magnet" parent-id="0">
+ <merchandise id="80" name="Rectangle Magnet (10 pack)" parent-id="0">
+ <merchandise id="81" name="Rectangle Magnet (100 pack)" parent-id="0">
+ <merchandise id="82" name="Cap" parent-id="0">
+ <merchandise id="83" name="Mini Button" parent-id="0">
+ <merchandise id="84" name="Mini Button (10 pack)" parent-id="0">
+ <merchandise id="85" name="Mini Button (100 pack)" parent-id="0">
+ <merchandise id="86" name="Framed Tile" parent-id="0">
+ <merchandise id="87" name="Postage Pal&trade;" parent-id="0">
+ <merchandise id="88" name="Dark T-Shirt" parent-id="0">
+ <merchandise id="89" name="Tote Bag" parent-id="0">
+ <merchandise id="90" name="Oversized Wall Calendar" parent-id="0">
+ <merchandise id="91" name="Vertical Wall Calendar" parent-id="0">
  </merchandise-collection>

Errors

Standard Errors as described here

Example

http://api.cafepress.com/merchandise.list.cp

merchandise.find.cp

This API can be used to get the details of a particular type of Merchandise specified by its ID. For instance in this example we will get the details of ID = 3 (i.e. White T-Shirt).

Signature

merchandise.find.cp?id=int-value

Parameters

Required:    
id - A valid Merchandise id (integer). You can get the id associated with each 
			Merchandise by calling merchandise.list.cp

Optional:    
None

Response

<?xml version="1.0" ?> 
- <merchandise id="3" name="White T-Shirt" parent-id="0">
- <features>
- <enumerable-feature name="PrintTechnology">
  <properties /> 
- <option>
- <properties>
  <int name="LegacyPrintTechnologyNumber" value="2" /> 
  </properties>
  Direct Printing 
  </option>
- <option>
- <properties>
  <int name="LegacyPrintTechnologyNumber" value="1" /> 
  </properties>
  Heat Transfer 
  </option>
  </enumerable-feature>
- <enumerable-feature name="Size">
  <properties /> 
- <option>
- <properties>
  <boolean name="Default" value="false" /> 
  <int name="LegacySizeNumber" value="1" /> 
  </properties>
  Kids Small 
  </option>
- <option>
- <properties>
  <boolean name="Default" value="false" /> 
  <int name="LegacySizeNumber" value="2" /> 
  </properties>
  Kids Medium 
  </option>
- <option>
- <properties>
  <boolean name="Default" value="false" /> 
  <int name="LegacySizeNumber" value="3" /> 
  </properties>
  Kids Large 
  </option>
- <option>
- <properties>
  <boolean name="Default" value="false" /> 
  <int name="LegacySizeNumber" value="4" /> 
  </properties>
  Small 
  </option>
- <option>
- <properties>
  <boolean name="Default" value="false" /> 
  <int name="LegacySizeNumber" value="5" /> 
  </properties>
  Medium 
  </option>
- <option>
- <properties>
  <boolean name="Default" value="true" /> 
  <int name="LegacySizeNumber" value="6" /> 
  </properties>
  Large 
  </option>
- <option>
- <properties>
  <boolean name="Default" value="false" /> 
  <int name="LegacySizeNumber" value="7" /> 
  </properties>
  X-Large 
  </option>
- <option>
- <properties>
  <boolean name="Default" value="false" /> 
  <int name="LegacySizeNumber" value="35" /> 
  </properties>
  2X-Large 
  </option>
- <option>
- <properties>
  <boolean name="Default" value="false" /> 
  <int name="LegacySizeNumber" value="9" /> 
  </properties>
  3X-Large 
  </option>
- <option>
- <properties>
  <boolean name="Default" value="false" /> 
  <int name="LegacySizeNumber" value="10" /> 
  </properties>
  4X-Large 
  </option>
  </enumerable-feature>
  </features>
  <constraints /> 
  <documentFeatureWrappers /> 
- <canvases>
- <canvas name="FrontCenter" units="inches">
  <height>10</height> 
  <width>10</width> 
  <minimum-dpi>100</minimum-dpi> 
  </canvas>
- <canvas name="BackCenter" units="inches">
  <height>10</height> 
  <width>10</width> 
  <minimum-dpi>100</minimum-dpi> 
  </canvas>
- <canvas name="FrontPocket" units="inches">
  <height>6</height> 
  <width>6</width> 
  <minimum-dpi>100</minimum-dpi> 
  </canvas>
- <canvas name="BackShoulder" units="inches">
  <height>4</height> 
  <width>10</width> 
  <minimum-dpi>100</minimum-dpi> 
  </canvas>
  </canvases>
- <properties>
  <int name="LegacyProductTypeId" value="2" /> 
  <price name="BasePrice" value="13.99" /> 
  <string name="CategoryCaption" value="Apparel" /> 
  <string name="CategoryId" value="2" /> 
  <string name="DefaultColor" value="N/A" /> 
  <string name="DefaultOrientation" value="Normal" /> 
  <string name="DefaultPerspective" value="Front" /> 
  <string name="DefaultSize" value="Large" /> 
  <string name="Description" value="White T-Shirt" /> 
  <string name="MerchandiseAvailability" value="All Stores | Permanent Item" /> 
  <string name="MerchandiseAvailabilityStatusId" value="3" /> 
  <string name="ShortCaption" value="White T-Shirt" /> 
  <string name="ShortDescription" value="White T" /> 
  <string name="StockAvailability" value="In Stock, will ship in 2 business days" /> 
  <string name="StockAvailablilityStatusId" value="1" /> 
  </properties>
  </merchandise>

Errors

Standard Errors as described here

Example

http://api.cafepress.com/merchandise.find.cp?id=3 (Get the details of the White T-Shirt)

merchandise.findByName.cp

Just like the previous API, this API can be used to get the details of a particular type of Merchandise. The only difference is that you can find the details by Name instead of by an ID.

Signature

merchandise.findbyName.cp?name=string-value

Parameters

Required:    
name - Merchandise Name (string). You can get the name associated 
       with each Merchandise by calling merchandise.list.cp

Optional:    
None

Response

Same as merchandise.find.cp

Errors

Standard Errors as described here

Example

http://api.cafepress.com/merchandise.findByName.cp?name=mug

Home \| Tools \| Ideas \| APIs \| Discussions \| Partners \| Contact Us	Signup to receive updates
Copyright © 2006 CafePress.com, Inc. All Rights Reserved. Designated trademarks and brands are the property of their respective owners. Use of this website constitutes acceptance of the Terms of Service and Privacy Policy.