squeejee-remixr 0.1.0

data/History

@@ -0,0 +1 @@
+0.0.1 - initial release

data/License

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Squeejee
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,76 @@
+# remixr
+
+The Ruby BestBuy [Remix API](http://remix.bestbuy.com/docs) gem. Remix is an API that gives you access to BestBuy.com's product catalog data and more. 
+
+## Install
+
+    sudo gem install remixr
+ 
+## Usage
+
+    Remixr.api_key = 'OU812' # get yours from http://remix.bestbuy.com/apps/register
+    client = Remixr::Client.new
+ 
+### Find stores
+
+    # find stores within 50 miles of ZIP 76227
+    stores = client.stores({:area => ['76227', 50]}).fetch.stores
+
+    stores.first
+
+    => {"city"=>"Denton", "longName"=>"Best Buy - Denton", "name"=>"Denton", "region"=>"TX", "address"=>"1800 S Loop 288, Ste 102 Bldg 1 ", "country"=>"US", "lng"=>-97.10067, "postalCode"=>"76205", "phone"=>"940-384-9581", "hours"=>"Mon: 10-9; Tue: 10-9; Wed: 10-9; Thurs: 10-9; Fri: 10-10; Sat: 10-10; Sun: 11-8", "storeId"=>827, "fullPostalCode"=>"76205", "lat"=>33.192524, "distance"=>9.79}
+ 
+ 
+### Find products
+
+    # fetch first page of products on sale below 20 bucks
+    products = client.products({:salePrice => {'$lt' => 20.00}}).fetch.products
+
+    # fetch only SKU and salePrice 
+    products = client.products({:salePrice => {'$lt' => 20.00}}).fetch.products
+    
+### Chaining
+
+You can also chain `stores` and `products` to return stores and nested product info or vice versa
+
+    # find stores within 50 miles of ZIP 76227 and products over three G's
+    
+    stores = client.stores({:area => ['76227', 50]}).products({:salePrice => {'$gt' => 3000}}).fetch.stores
+    
+    stores.first.products.first.shortDescription
+    
+    #=> "ENERGY STAR Qualified 4 HDMI inputs; gray Touch of Color bezel; 16:9 aspect ratio"
+
+### Fetching
+
+All calls terminate in a call to `fetch` which takes the following options
+
+    :page - positive integer for page number
+    :show - comma delimited string or array of field names to show
+    :sort - hash or string of sort info {'fieldname' => 'asc|desc'}
+
+
+### Conditional operators
+
+We took a page out of [MongoDB's](http://www.mongodb.org/display/DOCS/Advanced+Queries#AdvancedQueries-ConditionalOperators%3A%3C%2C%3C%3D%2C%3E%2C%3E%3D) playbook and mapped conditional operators to text equivalents to avoid having these be keys to hashes:
+
+    {:salePrice => {'$gte' => 300.00}}
+    => salePrice > 300.00
+    
+    $gte - greater than or equal to : field > value
+    $lte - less than or equal to : field > value
+    $gt - greater than : field > value
+    $lt - less than : field > value
+    $ne - not equal to : field != value
+
+More in the examples folder:
+
+[http://github.com/squeejee/remixr/tree/master/examples](http://github.com/squeejee/remixr/tree/master/examples)
+
+### Documentation
+
+[http://rdoc.info/projects/squeejee/remixr](http://rdoc.info/projects/squeejee/remixr)
+
+#### Copyright
+
+Copyright (c) 2009 Squeejee. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,103 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name              = "remixr"
+    gem.description       = %Q{wrapper for the BestBuy Remix api}
+    gem.summary           = %Q{wrapper for the BestBuy Remix api}
+    gem.email             = "wynn@squeejee.com"
+    gem.homepage          = "http://github.com/squeejee/remixr"
+    gem.authors           = ["Wynn Netherland", "Jim Mulholland"]
+    gem.rubyforge_project = "remixr"
+    gem.files             = FileList["[A-Z]*", "{examples,lib,test}/**/*"]
+    
+    gem.add_dependency('mash', '0.0.3')
+    gem.add_dependency('httparty', '0.4.3')
+    
+    gem.add_development_dependency('thoughtbot-shoulda')
+    gem.add_development_dependency('jeremymcanally-matchy')
+    gem.add_development_dependency('mocha')
+    gem.add_development_dependency('fakeweb')
+    gem.add_development_dependency('mash')
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = false
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "remixr #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+begin
+  require 'rake/contrib/sshpublisher'
+  namespace :rubyforge do
+    
+    desc "Release gem and RDoc documentation to RubyForge"
+    task :release => ["rubyforge:release:gem", "rubyforge:release:docs"]
+    
+    namespace :release do
+      desc "Publish RDoc to RubyForge."
+      task :docs => [:rdoc] do
+        config = YAML.load(
+            File.read(File.expand_path('~/.rubyforge/user-config.yml'))
+        )
+
+        host = "#{config['username']}@rubyforge.org"
+        remote_dir = "/var/www/gforge-projects/remixr/rdoc"
+        local_dir = 'rdoc'
+
+        Rake::SshDirPublisher.new(host, remote_dir, local_dir).upload
+      end
+      
+      # task :website do
+      #   config = YAML.load(
+      #       File.read(File.expand_path('~/.rubyforge/user-config.yml'))
+      #   )
+      # 
+      #   host = "#{config['username']}@rubyforge.org"
+      #   remote_dir = "/var/www/gforge-projects/remixr/"
+      #   local_dir = 'website'
+      #   
+      #   Rake::SshDirPublisher.new(host, remote_dir, local_dir).upload
+      # end
+    end
+  end
+rescue LoadError
+  puts "Rake SshDirPublisher is unavailable or your rubyforge environment is not configured."
+end

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:patch: 0
+:major: 0
+:minor: 1

data/examples/chaining.rb

@@ -0,0 +1,7 @@
+Remixr.api_key = 'OU812' # get yours from http://remix.bestbuy.com/apps/register
+client = Remixr::Client.new
+
+# find stores within 50 miles of ZIP 76227 and products over three G's
+stores = client.stores({:area => ['76227', 50]}).products({:salePrice => {'$gt' => 3000}}).fetch.stores
+stores.first.products.first.shortDescription
+#=> "ENERGY STAR Qualified 4 HDMI inputs; gray Touch of Color bezel; 16:9 aspect ratio"

data/examples/find_products.rb

@@ -0,0 +1,13 @@
+Remixr.api_key = 'OU812' # get yours from http://remix.bestbuy.com/apps/register
+client = Remixr::Client.new
+
+# fetch first page of products on sale below 20 bucks
+products = client.products({:salePrice => {'$lt' => 20.00}}).fetch.products
+
+products.first
+# => {"url"=>"http://www.bestbuy.com/site/olspage.jsp?skuId=7524468&type=product&id=1494684&cmp=RMX&ky=1uYnAnk1pohGgQVwEClo8PHv4SN4C5MeL", "inStoreAvailability"=>true, "albumLabel"=>nil, "genre"=>nil, "sku"=>7524468, "affiliateUrl"=>nil, "cjAffiliateAddToCartUrl"=>nil, "salesRankLongTerm"=>2451, "addToCartUrl"=>"http://www.bestbuy.com/site/olspage.jsp?id=pcmcat152200050035&type=category&cmp=RMX&ky=1uYnAnk1pohGgQVwEClo8PHv4SN4C5MeL&qvsids=7524468", "remoteControlImage"=>nil, "affiliateAddToCartUrl"=>nil, "largeImage"=>nil, "new"=>false, "salePrice"=>15.99, "artistId"=>"BYPart1061717", "inStoreAvailabilityUpdateDate"=>"2007-07-27T20:20:50", "largeFrontImage"=>nil, "department"=>"VIDEO/COMPACT DISC", "artistName"=>"Purple City", "accessoriesImage"=>nil, "format"=>"CD", "customerReviewCount"=>nil, "regularPrice"=>15.99, "amgId"=>nil, "freeShipping"=>false, "salesRankShortTerm"=>250, "shortDescription"=>nil, "specialOrder"=>false, "nationalFeatured"=>false, "manufacturer"=>nil, "salesRankMediumTerm"=>570, "energyGuideImage"=>nil, "inStoreAvailabilityText"=>"Store Pickup: Limited Availability", "alternateViewsImage"=>nil, "mobileUrl"=>"http://m.bestbuy.com/r/1494684/7524468/", "subclass"=>"RAP", "name"=>"\"Paris to Purple City\"", "cjAffiliateUrl"=>nil, "image"=>"http://images.bestbuy.com/BestBuy_US/images/products/7524/7524468.jpg", "shippingCost"=>1.59, "subclassId"=>1009, "upc"=>"823979901426", "onlineAvailabilityText"=>"Shipping: Usually leaves our warehouse in 1 business day", "onlineAvailabilityUpdateDate"=>"2007-07-27T20:20:50", "topViewImage"=>nil, "class"=>"COMPACT DISC", "active"=>true, "classId"=>77, "parentalAdvisory"=>false, "thumbnailImage"=>"http://images.bestbuy.com/BestBuy_US/images/products/7524/7524468s.jpg", "leftViewImage"=>nil, "rightViewImage"=>nil, "productId"=>1494684, "source"=>"bestbuy", "customerReviewAverage"=>nil, "activeUpdateDate"=>"2007-07-27T20:20:50", "mediumImage"=>nil, "startDate"=>#<Date: 4906945/2,0,2299161>, "departmentId"=>8, "angleImage"=>nil, "albumVersion"=>nil, "spin360Url"=>nil, "priceUpdateDate"=>"2008-02-09T00:10:37", "categoryPath"=>[<Mash id="cat00000" name="Best Buy">, <Mash id="abcat0600000" name="Music & Movies">, <Mash id="cat02001" name="Music">, <Mash id="cat02012" name="Rap & Hip-Hop">, <Mash id="cat02719" name="Rap">], "printOnly"=>false, "releaseDate"=>#<Date: 4907365/2,0,2299161>, "search"=>nil, "copyright"=>nil, "onSale"=>false, "itemUpdateDate"=>"2009-02-03T03:50:13", "albumTitle"=>"\"Paris to Purple City\"", "type"=>"Music", "originalReleaseDat
+
+
+# fetch only SKU and salePrice 
+products = client.products({:salePrice => {'$lt' => 20.00}}).fetch.products
+# => [{"salePrice"=>10.99, "sku"=>7000032}, {"salePrice"=>10.99, "sku"=>11467058}, {"salePrice"=>13.99, "sku"=>7873884}, {"salePrice"=>11.99, "sku"=>15444798}, {"salePrice"=>13.99, "sku"=>9113256}, {"salePrice"=>13.99, "sku"=>5797649}, {"salePrice"=>13.99, "sku"=>8890961}, {"salePrice"=>14.99, "sku"=>17338506}, {"salePrice"=>11.99, "sku"=>9242642}, {"salePrice"=>13.99, "sku"=>9171353}]

data/examples/find_stores.rb

@@ -0,0 +1,11 @@
+Remixr.api_key = 'OU812' # get yours from http://remix.bestbuy.com/apps/register
+client = Remixr::Client.new
+
+# find stores within 50 miles of ZIP 76227
+stores = client.stores({:area => ['76227', 50]}).fetch.stores
+
+stores.first
+# => {"city"=>"Denton", "longName"=>"Best Buy - Denton", "name"=>"Denton", "region"=>"TX", "address"=>"1800 S Loop 288, Ste 102 Bldg 1 ", "country"=>"US", "lng"=>-97.10067, "postalCode"=>"76205", "phone"=>"940-384-9581", "hours"=>"Mon: 10-9; Tue: 10-9; Wed: 10-9; Thurs: 10-9; Fri: 10-10; Sat: 10-10; Sun: 11-8", "storeId"=>827, "fullPostalCode"=>"76205", "lat"=>33.192524, "distance"=>9.79}
+
+
+

data/lib/remixr.rb

@@ -0,0 +1,29 @@
+require 'forwardable'
+require 'rubygems'
+
+gem 'mash', '0.0.3'
+require 'mash'
+
+gem 'httparty', '0.4.3'
+require 'httparty'
+
+class APIKeyNotSet   < StandardError; end
+
+module Remixr
+  
+  # Get your API key from http://remix.bestbuy.com/apps/register
+  def self.api_key
+    raise APIKeyNotSet if @api_key.nil?
+  
+    @api_key
+  end
+  
+  def self.api_key=(api_key)
+    @api_key = api_key
+  end
+  
+end
+
+directory = File.expand_path(File.dirname(__FILE__))
+
+require File.join(directory, 'remixr', 'client')

data/lib/remixr/client.rb

@@ -0,0 +1,157 @@
+module Remixr
+  class Client
+    include HTTParty
+    base_uri 'api.remix.bestbuy.com/v1'
+    format :json
+    
+    attr_reader :api_key, :store_filters, :product_filters
+    
+    # Get your api_key found here http://remix.bestbuy.com/apps/register
+    def initialize(api_key=nil)
+      @api_key = api_key
+      @api_key ||= Remixr.api_key
+      
+      @api_path = ''
+      @store_filters = {}
+      @product_filters = {}
+    end
+    
+    # Example filters:
+    # Stores within 50 miles of ZIP 76227
+    #   stores({:area => [76227,50]})
+    #   GET /v1/stores(area(76227,50))
+    #  
+    # Stores west of the Pecos
+    #   stores({:lng => {'$lt' => -104.304199}})
+    #   GET /v1/stores(lng>-104.304199)
+    #
+    def stores(filters={})
+      unless @api_path.include?('stores()')
+        @api_path += '+' unless @api_path.blank?
+        @api_path += "stores()"
+      end
+      @store_filters.merge!(filters)
+      self
+    end
+    
+    # Convenience method for finding a store by zip
+    #   stores.in_zip(76227)
+    #   GET /v1/stores(postalCode=76227)
+    def in_zip(zip)
+      self.stores({'postalCode' => zip})
+    end
+    
+    # Convenience method for finding a store by region
+    #   stores.in_region('TX')
+    #   GET /v1/stores(region=TX)
+    def in_region(region)
+      self.stores({'region' => region})
+    end
+    
+    # Example filters:
+    # Products under 20 bucks
+    #   products({:salePrice => {'$lt' => 20.00}})
+    #   GET /v1/products(salePrice<20.00)
+    def products(filters={})
+      unless @api_path.include?('products()')
+        @api_path += '+' unless @api_path.blank?
+        @api_path += "products()"
+      end
+      @product_filters.merge!(filters)
+      self
+    end
+    
+    
+    # Executes the search
+    # Possible options:
+    # :page - positive integer for page number
+    # :show - comma delimited string or array of field names to show
+    # :sort - hash or string of sort info {'fieldname' => 'asc|desc'}
+    def fetch(options={})
+      opts = {:apiKey => @api_key, :format => 'json'}
+      opts.merge!(scrub_options(options))
+      
+      apply_store_filters
+      apply_product_filters
+      @api_path = URI.escape(@api_path)
+      response = self.class.get("/" + @api_path, :query => opts)
+      @api_path = ''
+      Mash.new response
+    end
+    
+    private
+      def apply_store_filters
+        if @store_filters.keys.blank? 
+          @api_path.gsub!("stores()", "stores")
+        else
+          @api_path.gsub!("stores()", "stores(#{filter_params_string(@store_filters)})")
+        end
+      end
+      
+      def apply_product_filters
+        if @product_filters.keys.blank? 
+          @api_path.gsub!("products()", "products")
+        else
+          @api_path.gsub!("products()", "products(#{filter_params_string(@product_filters)})")
+        end
+      end
+      
+      def filter_params_string(filters)
+        return "" unless filters.is_a?(Hash)
+        
+        filters = Mash.new filters.to_hash # calling Mash.new on a mash is bad mmmm k?
+        params = []
+        filters.each do |key, value|
+          if value.is_a?(Hash)
+            inner_hash = value
+            case inner_hash.keys.first
+            when "$gt"
+              params << "#{key}>#{inner_hash.values.first}"
+            when "$lt"
+              params << "#{key}<#{inner_hash.values.first}"
+            when "$gte"
+              params << "#{key}>=#{inner_hash.values.first}"
+            when "$lte"
+              params << "#{key}<=#{inner_hash.values.first}"
+            when "$ne"
+              params << "#{key}!=#{inner_hash.values.first}"
+            when "$in"
+              params << "#{key} in(#{inner_hash.values.first.join(',')})"
+            end
+          elsif value.is_a?(Array)
+            params << "#{key}(#{value.join(',')})"
+          else
+            params << "#{key}=#{value}"
+          end
+        end
+        
+        if params.blank?
+          ""
+        else
+          "#{params.join('&')}"
+        end
+      end
+      
+      def scrub_options(options)
+        options = Mash.new(options.to_hash)
+        show = options.delete('show')
+        unless show.blank?
+          if show.is_a?(String)
+            options['show'] = show
+          elsif show.is_a?(Array)
+            options['show'] = show.join(',')
+          end
+        end
+        sort = options.delete('sort')
+        unless sort.blank?
+          if sort.is_a?(Hash)
+            options['sort'] = "#{sort.keys.first}.#{sort.values.first}"
+          else
+            options['sort'] = sort
+          end
+        end
+        options
+      end
+    
+  end
+end

data/test/fixtures/product_search_digital_photo_printer.json

@@ -0,0 +1,216 @@
+{
+  "totalPages": 1,
+  "currentPage": 1,
+  "queryTime": "0.346",
+  "from": 1,
+  "products": [
+    {
+      "shippingWeight": ".2208",
+      "printOnly": false,
+      "description": null,
+      "url": "http:\/\/www.bestbuy.com\/site\/olspage.jsp?skuId=4660432&type=product&id=1051806199755&cmp=RMX&ky=1uYnAnk1pohGgQVwEClo8PHv4SN4C5MeL",
+      "inStoreAvailability": true,
+      "sku": 4660432,
+      "cjAffiliateAddToCartUrl": null,
+      "search": null,
+      "addToCartUrl": "http:\/\/www.bestbuy.com\/site\/olspage.jsp?id=pcmcat152200050035&type=category&cmp=RMX&ky=1uYnAnk1pohGgQVwEClo8PHv4SN4C5MeL&qvsids=4660432",
+      "affiliateAddToCartUrl": null,
+      "new": false,
+      "accessoriesImage": null,
+      "weight": null,
+      "salePrice": 28.99,
+      "dollarSavings": 0.0,
+      "inStoreAvailabilityUpdateDate": "2009-01-21T01:34:16",
+      "largeFrontImage": "http:\/\/images.bestbuy.com\/BestBuy_US\/images\/products\/4660\/4660432_sa.jpg",
+      "freeShipping": true,
+      "navigability": true,
+      "height": null,
+      "color": "Photo Multicolor",
+      "remoteControlImage": null,
+      "largeImage": "http:\/\/images.bestbuy.com\/BestBuy_US\/images\/products\/4660\/4660432_sb.jpg",
+      "format": null,
+      "salesRankLongTerm": 1156,
+      "inStoreAvailabilityText": "Store Pickup: Available at most stores",
+      "regularPrice": 28.99,
+      "salesRankShortTerm": 244,
+      "nationalFeatured": false,
+      "manufacturer": "HP",
+      "onlineAvailabilityText": "Shipping: Usually leaves our warehouse in 1 business day",
+      "salesRankMediumTerm": 473,
+      "department": "PHOTO\/COMMODITIES",
+      "energyGuideImage": null,
+      "customerReviewCount": null,
+      "mobileUrl": "http:\/\/m.bestbuy.com\/r\/1051806199755\/4660432\/",
+      "name": "HP 58 Photo Inkjet Cartridge - Photo Multicolor",
+      "image": "http:\/\/images.bestbuy.com\/BestBuy_US\/images\/products\/4660\/4660432_sc.jpg",
+      "shippingCost": 0.0,
+      "shortDescription": "Compatible with specified HP Deskjet, Photosmart, all-in-one, Officejet and digital copier printers",
+      "specialOrder": false,
+      "customerReviewAverage": null,
+      "warrantyParts": null,
+      "depth": null,
+      "topViewImage": null,
+      "upc": "808736183857",
+      "class": "PAPER\/OFFICE SUPPLIE",
+      "departmentId": 5,
+      "active": true,
+      "classId": 117,
+      "subclass": "INK\/TONER SUPPLIES",
+      "rightViewImage": null,
+      "cjAffiliateUrl": null,
+      "priceUpdateDate": "2009-03-10T06:13:56",
+      "alternateViewsImage": null,
+      "warrantyLabor": null,
+      "source": "bestbuy",
+      "releaseDate": null,
+      "modelNumber": "C6658AN",
+      "longDescription": "Multicolor photo ink cartridge compatible with specified HP Deskjet, Photosmart, all-in-one, Officejet and digital copier printers. Fade-resistant.",
+      "onlineAvailabilityUpdateDate": "2009-01-21T01:34:16",
+      "startDate": "2002-08-04",
+      "subclassId": 402,
+      "angleImage": null,
+      "thumbnailImage": "http:\/\/images.bestbuy.com\/BestBuy_US\/images\/products\/4660\/4660432_s.gif",
+      "leftViewImage": null,
+      "type": "HardGood",
+      "productId": 1051806199755,
+      "orderable": "Available",
+      "categoryPath": [
+        {
+          "name": "Best Buy",
+          "id": "cat00000"
+        },
+        {
+          "name": "Cell Phones & Office",
+          "id": "abcat0800000"
+        },
+        {
+          "name": "Ink & Toner",
+          "id": "abcat0807000"
+        },
+        {
+          "name": "Ink",
+          "id": "abcat0807001"
+        },
+        {
+          "name": "Hewlett-Packard",
+          "id": "abcat0807005"
+        }
+      ],
+      "mediumImage": "http:\/\/images.bestbuy.com\/BestBuy_US\/images\/products\/4660\/4660432fp.gif",
+      "onSale": false,
+      "itemUpdateDate": "2009-07-28T19:23:43",
+      "affiliateUrl": null,
+      "activeUpdateDate": "2009-01-21T01:34:16",
+      "width": null,
+      "spin360Url": null,
+      "backViewImage": null,
+      "onlineAvailability": true
+    },
+    {
+      "shippingWeight": ".225",
+      "printOnly": false,
+      "description": null,
+      "url": "http:\/\/www.bestbuy.com\/site\/olspage.jsp?skuId=4312746&type=product&id=1051806147888&cmp=RMX&ky=1uYnAnk1pohGgQVwEClo8PHv4SN4C5MeL",
+      "inStoreAvailability": true,
+      "sku": 4312746,
+      "cjAffiliateAddToCartUrl": null,
+      "search": null,
+      "addToCartUrl": "http:\/\/www.bestbuy.com\/site\/olspage.jsp?id=pcmcat152200050035&type=category&cmp=RMX&ky=1uYnAnk1pohGgQVwEClo8PHv4SN4C5MeL&qvsids=4312746",
+      "affiliateAddToCartUrl": null,
+      "new": false,
+      "accessoriesImage": null,
+      "weight": null,
+      "salePrice": 39.99,
+      "dollarSavings": 0.0,
+      "inStoreAvailabilityUpdateDate": "2009-06-27T01:43:54",
+      "largeFrontImage": "http:\/\/images.bestbuy.com\/BestBuy_US\/images\/products\/4312\/4312746_sa.jpg",
+      "freeShipping": true,
+      "navigability": true,
+      "height": null,
+      "color": "Multicolor",
+      "remoteControlImage": null,
+      "largeImage": "http:\/\/images.bestbuy.com\/BestBuy_US\/images\/products\/4312\/4312746_sb.jpg",
+      "format": null,
+      "salesRankLongTerm": 599,
+      "inStoreAvailabilityText": "Store Pickup: Available at most stores",
+      "regularPrice": 39.99,
+      "salesRankShortTerm": 243,
+      "nationalFeatured": false,
+      "manufacturer": "HP",
+      "onlineAvailabilityText": "Shipping: Usually leaves our warehouse in 1 business day",
+      "salesRankMediumTerm": 473,
+      "department": "PHOTO\/COMMODITIES",
+      "energyGuideImage": null,
+      "customerReviewCount": 1,
+      "mobileUrl": "http:\/\/m.bestbuy.com\/r\/1051806147888\/4312746\/",
+      "name": "HP 57 Inkjet Cartridge - Multicolor",
+      "image": "http:\/\/images.bestbuy.com\/BestBuy_US\/images\/products\/4312\/4312746_sc.jpg",
+      "shippingCost": 0.0,
+      "shortDescription": "Compatible with specified HP Deskjet, Photosmart, all-in-one, Officejet and digital copier printers",
+      "specialOrder": false,
+      "customerReviewAverage": 5.0,
+      "warrantyParts": null,
+      "depth": null,
+      "topViewImage": null,
+      "upc": "725184712340",
+      "class": "PAPER\/OFFICE SUPPLIE",
+      "departmentId": 5,
+      "active": true,
+      "classId": 117,
+      "subclass": "INK\/TONER SUPPLIES",
+      "rightViewImage": null,
+      "cjAffiliateUrl": null,
+      "priceUpdateDate": "2009-03-10T00:13:56",
+      "alternateViewsImage": null,
+      "warrantyLabor": null,
+      "source": "bestbuy",
+      "releaseDate": null,
+      "modelNumber": "C6657AN",
+      "longDescription": "Tricolor ink cartridge creates bright, photo-quality color. Compatible with specified HP Deskjet, Photosmart, all-in-one, Officejet and digital copier printers",
+      "onlineAvailabilityUpdateDate": "2009-06-27T01:43:54",
+      "startDate": "2002-08-15",
+      "subclassId": 402,
+      "angleImage": null,
+      "thumbnailImage": "http:\/\/images.bestbuy.com\/BestBuy_US\/images\/products\/4312\/4312746_s.gif",
+      "leftViewImage": null,
+      "type": "HardGood",
+      "productId": 1051806147888,
+      "orderable": "Available",
+      "categoryPath": [
+        {
+          "name": "Best Buy",
+          "id": "cat00000"
+        },
+        {
+          "name": "Cell Phones & Office",
+          "id": "abcat0800000"
+        },
+        {
+          "name": "Ink & Toner",
+          "id": "abcat0807000"
+        },
+        {
+          "name": "Ink",
+          "id": "abcat0807001"
+        },
+        {
+          "name": "Hewlett-Packard",
+          "id": "abcat0807005"
+        }
+      ],
+      "mediumImage": "http:\/\/images.bestbuy.com\/BestBuy_US\/images\/products\/4312\/4312746fp.gif",
+      "onSale": false,
+      "itemUpdateDate": "2009-07-28T19:21:16",
+      "affiliateUrl": null,
+      "activeUpdateDate": "2009-06-27T01:43:54",
+      "width": null,
+      "spin360Url": null,
+      "backViewImage": null,
+      "onlineAvailability": true
+    }
+  ],
+  "total": 2,
+  "to": 2,
+  "canonicalUrl": "\/v1\/products(|)?format=json&apiKey=OU812",
+  "totalTime": "0.351"
+}