Newegg Api Gem

A Ruby Wrapper for the Newegg Mobile API

Installation

Add this line to your application's Gemfile:

gem 'newegg-api', :git => 'git://github.com/chrismagnacca/newegg-api.git'

And then execute:

$ bundle install

Lastly, require the gem as such:

require 'newegg'

Usage

Obtain Store Information

Newegg.stores #=> Array<Newegg::Store>

Newegg::Store #=> Class Instance Variables
title,              # store title
store_department,   # store department name
store_id,           # store id
show_see_all_deals, # boolean if store contains deals
categories          # array of category ids

Obtain Categories for a Store

Newegg.categories(store_id) #=> Array<Newegg::Category>

Newegg::Category #=> Class Instance Variables 
description,        # description of the returned Category 
category_type,      # category type
category_id,        # category id
store_id,           # store id
show_see_all_deals, # boolean if category contains deals
node_id             # node id

Navigate through Categories

Newegg.navigate(store_id, category_id, node_id) #=> Array<Newegg::Category>

Search for Products (all arguments optional)

Newegg.search(store_id: STORE_ID, category_id: CAT_ID, sub_category_id: SUB_CAT_ID, node_id: NODE_ID, page_number: 1, sort: "FEATURED", keywords: KEYWORDS) #=> json

{
    "NavigationContentList" => [
    {"TitleItem" => {"Description" => "Useful Links",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "Price",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "Manufacturer",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "Type",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "Color",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "Case Material",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "With Power Supply",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "Power Supply",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "With Side Panel Window",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "External 5.25\" Drive Bays",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "External 3.5\" Drive Bays",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "Power Supply Mounted",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "Internal 3.5\" Drive Bays",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "Front Ports",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "80mm Fans",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "120mm Fans",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "250mm Fans",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "Side Air duct",  "NavigationItemList" => [{...}]},
    {"TitleItem" => {"Description" => "Expansion Slots", "NavigationItemList" => [{...}]}
    ],

    "RelatedLinkList" => nil,

    "CoremetricsInfo" => {"CategoryID" => "2010090007", ...}

    "IsAllComboBundle" => false,
    "CanBeCompare" => true,
    "MasterComboStoreId" => 0,
    "SubCategoryId" => 7,
    "HasDeactivatedItems" => false,
    "HasHasSimilarItems" => false,
    "SearchProvider" => 0,
    "SearchResultType" => 0,
    "ProductListItems" => [
    {"Title" => "Antec Three Hundred Illusion Black Steel ATX Mid Tower Computer Case", ...},
    {"Title" => "COOLER MASTER HAF X RC-942-KKN1 Black Steel/ Plastic ATX Full Tower Computer Case", ...}
    {"Title" => "Thermaltake VL84301W2Z V3 Black Edition with 430W  Power Supply ATX Mid Tower Computer Case", ...}
    ],
    "PaginationInfo" => {"TotalCount" => 572,
    "PageSize" => 20,
    "PageNumber" => 1,
    "PageCount" => 0}
}

Retrieve Product Specifications

Newegg.specifications(item_number)

{
    "NeweggItemNumber": "N82E16811147107",
    "Title": "Rosewill BLACKHAWK Gaming ATX Mid Tower Computer Case, come with Five Fans, window side panel, top HDD dock ",
    "SpecificationGroupList": [
    {
        "GroupName": "Model", "SpecificationPairList":
        [{"Key": "Brand", "Value": "Rosewill"},
        {"Key": "Model","Value": "BlackHawk"}]
    }
    {"GroupName": "Spec", "SpecificationPairList": [{..}]},
    {"GroupName": "Expansion", "SpecificationPairList": [{..}]},
    {"GroupName": "Front Ports", "SpecificationPairList": [{..}]},
    {"GroupName": "Cooling System", "SpecificationPairList": [{..}]},
    {"GroupName": "Physical Spec", "SpecificationPairList": [{..}]},
    {"GroupName": "Features", "SpecificationPairList": [{..}]},
    ]
}

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Added some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request