Find products

Product calls are used to get all information related to products, and the specific merchant offers for those products. One thing to note is that only offers will have affiliate links associated with them, the product itself will not have an affiliate URL. Therefore products with multiple offers will require an additional API call using the "product' parameter listed below. Our product numbers use a 64bit integer.

Request URL

http://api.popshops.com/v3/products.xml
http://api.popshops.com/v3/products.json

Response Formats

Required request parameters

Optional request parameters

Note that identifier parameter (i.e. "keyword_identifier", "keyword_isbn", "keyword_ean", "keyword_upc", "keyword_mpn") values will be interpreted as queries whenever a keyword parameter (i.e. "keyword", "keyword_name", "keyword_description") is also set; otherwise, identifier parameters will be interpreted as filters.

Response results

By default the response only brings back products. There are two cases where you will get actual offer information back.

1. The product only has a single offer. In this instance the offer will automatically be brought back.
2. You pass in a 'product' parameter. This is the case where you are requesting information about a specific product or products, and so all offer information for each product is returned.

Sample response

<?xml version="1.0" encoding="UTF-8"?>
<response status="200" message="ok"...>
  <parameters>...</parameters>
  <results>
    <products count="1535">
      <product brand="37254" offer_count="10" category="32277" image_url_large="http://www.popshops.com/img/public/o/0/2/352/18-3.jpg" price_min="149.99" 
        description="Logitech Squeezebox Radio (BLACK) brings a world of musicfree Internet radio subscription services or your personal digital music collection to any space in your home over your WiFi network." 
        image_url_medium="http://www.popshops.com/img/public/o/0/2/352/18-2.jpg" 
        price_max="214.54" name="Logitech Inc 930000101 Squeezebox Radio Black" 
        image_url_small="http://www.popshops.com/img/public/o/0/2/352/18-1.jpg" id="405966"></product>
    </products>
    <deals count="25">
      <deal start_on="05/06/2010" site_wide="no" end_on="01/01/2017" merchant="5653" 
        description="PROMO: Dented Box and Refurbished Items From Logitech" 
        image_url="http://www.ftjcfx.com/image-2133188-10762343" deal_type="4" 
        name="Save big with Dented Box products have cosmetic damage to the packaging, but product is new and fully warranted." id="209974" 
        url="http://r.popshops.com/r/V1dKVzJJRmlvM241ZnhFTitubEk5by9NblF6aDErd3NDNUNLR25HSmFsRjlPTEJKS25lVm16bXNnTnlBCm0yQ2wK"></deal>
      ...
    </deals>
  </results>
  <resources>
    <merchants count="25">
      <merchant logo_url="http://www.popshops.com/img/public/l/0/0/0/230-1.jpg" 
        count="268" name="Newegg.com" id="230"
        url="http://r.popshops.com/r/V1dKVzJJRmlvM241ZnhFTitubEk5bnhlTEMwbnprN1k1dEQxRDN6cjlUSkp2eVpzY2lha2d3OG1nUWxTClBzS2QK"></merchant>
      ....
    </merchants>
    <brands count="25">...</brands>
    <deal_types count="6">...</deal_types>
    <categories>
      <context>
        <category order="0" name="All" id="1"></category>
      </context>
      <matches>
        <category count="2" leaf="true" name="AM / FM &amp; Clock Radios" id="32280"></category>
        ...
      </matches>
    </categories>
  </resources>
  <filters>
    <filter type="selection" resource="merchant" name="merchant" parameter="merchant"></filter>
    <filter type="range" name="price" parameter="price">
      <values>
        <value count="1475" min="0" max="360"></value>
        ...
      </values>
    </filter>
    ...
  </filters>
</response>

{
   "resources":
   {
       "deal_types":
       {
           "count": 6,
           "deal_type":
           [
               {
                   "count": "1",
                   "name": "Sale/Clearance",
                   "id": "4"
               }
               ...
           ]
       },
       "brands":
       {
           "brand":
           [
               {
                   "count": "16",
                   "name": "Franklin Sports",
                   "id": "29727"
               },
               ...
           ],
           "count": 25
       },
       "categories":
       {
           "context":
           {
               "category":
               [
                   {
                       "order": "0",
                       "name": "All",
                       "id": "1"
                   }
               ]
           },
           "matches":
           {
               "category":
               [
                   {
                       "count": "2",
                       "leaf": "true",
                       "name": "AM / FM & Clock Radios",
                       "id": "32280"
                   },
                   ...
               ]
           }
       },
       "merchants":
       {
           "count": 25,
           "merchant":
           [
               {
                   "logo_url": "http://www.popshops.com/img/public/l/0/0/0/230-1.jpg",
                   "count": "268",
                   "name": "Newegg.com",
                   "id": "230",
                   "url": "http://r.popshops.com/r/TE1lK0VaWXRlNUt6RURHajhJMWFySnk0NWlYMFhjNUFhbS9TU2VtVHRXS0pKeXJaV0hpZU11T3ZENWxYCkNwS20K"
               },
               ...
           ]
       }
   },
   "filters":
   {
       "filter":
       [
           {
               "type": "selection",
               "resource": "merchant",
               "name": "merchant",
               "parameter": "merchant"
           },
           {
               "type": "selection",
               "resource": "brand",
               "name": "brand",
               "parameter": "brand"
           },
           ...
           {
               "type": "item",
               "resource": "category",
               "name": "category",
               "parameter": "category"
           }
       ]
   },
   "results":
   {
       "products":
       {
           "count": 1535,
           "product":
           [
               {
                   "brand": "37254",
                   "offer_count": "10",
                   "category": "32277",
                   "image_url_large": "http://www.popshops.com/img/public/o/0/2/352/18-3.jpg",
                   "price_min": "149.99",
                   "description": "Logitech Squeezebox Radio (BLACK) brings a world of musicfree Internet radio subscription services or your personal digital music collection to any space in your home over your WiFi network.",
                   "image_url_medium": "http://www.popshops.com/img/public/o/0/2/352/18-2.jpg",
                   "price_max": "214.54",
                   "name": "Logitech Inc 930000101 Squeezebox Radio Black",
                   "image_url_small": "http://www.popshops.com/img/public/o/0/2/352/18-1.jpg",
                   "id": "405966"
               },
               {
                   "brand": "37254",
                   "offer_count": "16",
                   "category": "32279",
                   "image_url_large": "http://www.capitolsupply.com/ImageServer.ashx?t=product&h=200&w=200&imageid=CS12935298",
                   "price_min": "79.99",
                   "description": "Enjoy crystal-clear calls and video chats and listen to up to 10 hours of music per charge with this Logitech 984-000204 Bluetooth-enabled boombox that features a specially designed acoustic chamber that delivers great sound with enhanced bass.",
                   "price_max": "119.37",
                   "name": "Logitech - Bluetooth-Enabled Boombox for Apple? iPod? and Most MP3 Players",
                   "id": "18725796"
               },
               {
                   "brand": "37254",
                   "offer_count": "3",
                   "category": "32275",
                   "image_url_large": "http://www.restockit.com/images/Product/medium/930000090.jpg",
                   "price_min": "309.42",
                   "description": "Logitech Squeezebox Touch. The color touch-screen Wi-Fi music player that lets you discover a world of music - all through your stereo!",
                   "price_max": "365.34",
                   "name": "Logitech Squeezebox Touch",
                   "id": "1334248"
               },
               ...
           ]
       },
       "deals":
       {
           "count": 25,
           "deal":
           [
               {
                   "start_on": "05/06/2010",
                   "site_wide": "no",
                   "end_on": "01/01/2017",
                   "merchant": "5653",
                   "description": "PROMO: Dented Box and Refurbished Items From Logitech",
                   "image_url": "http://www.ftjcfx.com/image-2133188-10762343",
                   "deal_type": "4",
                   "name": "Save big with Dented Box products have cosmetic damage to the packaging, but product is new and fully warranted.",
                   "id": "209974",
                   "url": "http://r.popshops.com/r/TE1lK0VaWXRlNUt6RURHajhJMWFySklleUFEc1JhQzNWNEoxeWJzSFNjcjNhL0FTd3pnZFIyeXlLUy83CkF3QkwK"
               },
               ...
           ]
       }
   },
   "status": 200,
   "parameters":
   [
       ...
   ],
   "message": "ok",
}

---