Querying Categories
GET /api/categories Returns a list of existing categories of bargain listings. These categories form the unified category taxonomy that we applied to bargain listings fed from multiple bargain sources. You can retrieve these categories at once by sending a GET request to the root categories URL. Without any URL parameters, the response in JSON simply cover all categories available in our system. A typical use of this API is to find out the ID of a category, then apply the ID (a.k.a. tag_id) toward GET deals get deals of the category. Example Request
curl -X GET \ -H "X-INAB-Application-Id: ${APPLICATION_ID}" \ -H "X-INAB-REST-API-Key: ${REST_API_KEY}" \ http://www.ineedabargain.com/api/categories Example Response { "authorized_in": 0.177, "processed_in": 0.043, "results": [ { "id": 1, "name": "Magazine", "type": "category", "countAll": 6254, "count30": 230, "count7": 71 }, { "id": 3, "name": "Credit Card", "type": "category", "countAll": 1146, "count30": 41, "count7": 10 }, { "id": 5, "name": "HDTV", "type": "category", "countAll": 15059, "count30": 372, "count7": 82 }, { "id": 6, "name": "Wii", "type": "category", "countAll": 3291, "count30": 30, "count7": 9 }, { "id": 7, "name": "iPhone", "type": "category", "countAll": 9692, "count30": 293, "count7": 80 }, { "id": 9, "name": "iPod", "type": "category", "countAll": 7577, "count30": 174, "count7": 37 }, { "id": 12, "name": "Laptop", "type": "category", "countAll": 20617, "count30": 678, "count7": 199 }, { "id": 23, "name": "Mouse", "type": "category", "countAll": 3349, "count30": 57, "count7": 16 }, { "id": 24, "name": "Netbook", "type": "category", "countAll": 1827, "count30": 7, "count7": 3 }, { "id": 26, "name": "GPS", "type": "category", "countAll": 5650, "count30": 127, "count7": 30 }, { "id": 27, "name": "LCD Monitor", "type": "category", "countAll": 5372, "count30": 112, "count7": 29 }, { "id": 28, "name": "MicroSDHC", "type": "category", "countAll": 1036, "count30": 44, "count7": 8 }, { "id": 32, "name": "Digital Camera", "type": "category", "countAll": 6519, "count30": 147, "count7": 47 }, { "id": 33, "name": "Shoe", "type": "category", "countAll": 14761, "count30": 580, "count7": 150 }, { "id": 34, "name": "Clothing", "type": "category", "countAll": 25416, "count30": 929, "count7": 237 }, { "id": 35, "name": "Garden", "type": "category", "countAll": 2230, "count30": 73, "count7": 29 }, { "id": 36, "name": "Software", "type": "category", "countAll": 12047, "count30": 303, "count7": 72 }, { "id": 37, "name": "Patio", "type": "category", "countAll": 678, "count30": 57, "count7": 12 }, { "id": 38, "name": "Dining", "type": "category", "countAll": 4309, "count30": 123, "count7": 47 }, { "id": 39, "name": "Vacation", "type": "category", "countAll": 4495, "count30": 185, "count7": 61 }, { "id": 40, "name": "Rental Car", "type": "category", "countAll": 675, "count30": 32, "count7": 6 }, { "id": 41, "name": "Toy", "type": "category", "countAll": 7414, "count30": 169, "count7": 46 }, { "id": 42, "name": "Sport", "type": "category", "countAll": 6641, "count30": 210, "count7": 64 }, { "id": 43, "name": "Golf", "type": "category", "countAll": 1564, "count30": 63, "count7": 11 }, { "id": 44, "name": "Kitchen", "type": "category", "countAll": 2044, "count30": 57, "count7": 15 }, { "id": 45, "name": "Handbag", "type": "category", "countAll": 1875, "count30": 73, "count7": 11 }, { "id": 49, "name": "PS3", "type": "category", "countAll": 5015, "count30": 116, "count7": 31 }, { "id": 50, "name": "Xbox", "type": "category", "countAll": 7004, "count30": 243, "count7": 63 }, { "id": 51, "name": "Coffee", "type": "category", "countAll": 4389, "count30": 205, "count7": 48 }, { "id": 52, "name": "Watch", "type": "category", "countAll": 9944, "count30": 259, "count7": 55 }, { "id": 53, "name": "Printer", "type": "category", "countAll": 4202, "count30": 88, "count7": 34 }, { "id": 54, "name": "Ink", "type": "category", "countAll": 1366, "count30": 54, "count7": 12 }, { "id": 55, "name": "Toner", "type": "category", "countAll": 443, "count30": 15, "count7": 2 }, { "id": 56, "name": "Fragrance", "type": "category", "countAll": 867, "count30": 27, "count7": 5 }, { "id": 57, "name": "Makeup", "type": "category", "countAll": 1608, "count30": 54, "count7": 12 }, { "id": 58, "name": "Hair Care", "type": "category", "countAll": 1452, "count30": 41, "count7": 6 }, { "id": 59, "name": "Bath", "type": "category", "countAll": 2015, "count30": 56, "count7": 13 }, { "id": 60, "name": "Body", "type": "category", "countAll": 2979, "count30": 116, "count7": 30 }, { "id": 61, "name": "Diamond", "type": "category", "countAll": 5027, "count30": 97, "count7": 27 }, { "id": 62, "name": "Ring", "type": "category", "countAll": 1667, "count30": 43, "count7": 16 }, { "id": 63, "name": "Jewelry", "type": "category", "countAll": 16715, "count30": 429, "count7": 104 }, { "id": 64, "name": "Personal Finance", "type": "category", "countAll": 1356, "count30": 33, "count7": 9 }, { "id": 66, "name": "iPad", "type": "category", "countAll": 5981, "count30": 229, "count7": 66 }, { "id": 68, "name": "Flower", "type": "category", "countAll": 837, "count30": 12, "count7": 1 }, { "id": 69, "name": "Solar", "type": "category", "countAll": 1248, "count30": 20, "count7": 5 }, { "id": 70, "name": "Sunglasses", "type": "category", "countAll": 2694, "count30": 87, "count7": 29 }, { "id": 71, "name": "Fitness", "type": "category", "countAll": 1899, "count30": 46, "count7": 16 }, { "id": 72, "name": "DVD Burner", "type": "category", "countAll": 482, "count30": 9, "count7": 0 }, { "id": 74, "name": "Battery", "type": "category", "countAll": 2770, "count30": 71, "count7": 18 }, { "id": 75, "name": "Portable HD", "type": "category", "countAll": 1628, "count30": 60, "count7": 19 }, { "id": 76, "name": "Photo", "type": "category", "countAll": 4275, "count30": 152, "count7": 33 }, { "id": 77, "name": "Flip Flop", "type": "category", "countAll": 595, "count30": 21, "count7": 5 }, { "id": 78, "name": "USB Flash Drive", "type": "category", "countAll": 3150, "count30": 149, "count7": 31 }, { "id": 79, "name": "Mini PC", "type": "category", "countAll": 683, "count30": 11, "count7": 5 }, { "id": 80, "name": "Cell Phone", "type": "category", "countAll": 4127, "count30": 152, "count7": 43 }, { "id": 81, "name": "Stereo", "type": "category", "countAll": 1651, "count30": 84, "count7": 19 }, { "id": 82, "name": "Bluetooth Headset", "type": "category", "countAll": 1594, "count30": 48, "count7": 13 }, { "id": 85, "name": "Book", "type": "category", "countAll": 4205, "count30": 212, "count7": 54 }, { "id": 86, "name": "Address Label", "type": "category", "countAll": 299, "count30": 8, "count7": 1 }, { "id": 89, "name": "Jean", "type": "category", "countAll": 3974, "count30": 151, "count7": 62 }, { "id": 90, "name": "PSP", "type": "category", "countAll": 321, "count30": 4, "count7": 0 }, { "id": 91, "name": "Stroller", "type": "category", "countAll": 582, "count30": 11, "count7": 5 }, { "id": 92, "name": "iMac", "type": "category", "countAll": 423, "count30": 16, "count7": 4 }, { "id": 93, "name": "MacBook Pro", "type": "category", "countAll": 523, "count30": 34, "count7": 6 }, { "id": 94, "name": "Pizza", "type": "category", "countAll": 658, "count30": 17, "count7": 2 }, { "id": 97, "name": "Plus Size", "type": "category", "countAll": 1379, "count30": 76, "count7": 24 }, { "id": 98, "name": "Pet", "type": "category", "countAll": 2807, "count30": 73, "count7": 19 }, { "id": 99, "name": "Luggage", "type": "category", "countAll": 993, "count30": 34, "count7": 10 }, { "id": 100, "name": "Las Vegas", "type": "category", "countAll": 1090, "count30": 81, "count7": 18 }, { "id": 101, "name": "Solid State Drive", "type": "category", "countAll": 2798, "count30": 199, "count7": 56 }, { "id": 103, "name": "Bike", "type": "category", "countAll": 2045, "count30": 55, "count7": 13 }, { "id": 105, "name": "Vitamin", "type": "category", "countAll": 1013, "count30": 53, "count7": 9 }, { "id": 106, "name": "Skin Care", "type": "category", "countAll": 1158, "count30": 31, "count7": 6 }, { "id": 109, "name": "Video Card", "type": "category", "countAll": 1965, "count30": 48, "count7": 14 }, { "id": 110, "name": "Internal HD", "type": "category", "countAll": 1840, "count30": 41, "count7": 18 }, { "id": 111, "name": "Speaker", "type": "category", "countAll": 5679, "count30": 178, "count7": 40 }, { "id": 112, "name": "Candle", "type": "category", "countAll": 895, "count30": 20, "count7": 5 }, { "id": 113, "name": "Cotton Sheet", "type": "category", "countAll": 321, "count30": 7, "count7": 3 }, { "id": 114, "name": "Computer Case", "type": "category", "countAll": 986, "count30": 38, "count7": 11 }, { "id": 115, "name": "Motherboard", "type": "category", "countAll": 754, "count30": 20, "count7": 4 }, { "id": 116, "name": "Home Decor", "type": "category", "countAll": 2420, "count30": 83, "count7": 20 }, { "id": 117, "name": "Grocery", "type": "category", "countAll": 4979, "count30": 221, "count7": 65 }, { "id": 120, "name": "SLR Lens", "type": "category", "countAll": 1371, "count30": 52, "count7": 16 }, { "id": 121, "name": "Camcorder", "type": "category", "countAll": 2250, "count30": 40, "count7": 16 }, { "id": 122, "name": "Tools", "type": "category", "countAll": 6976, "count30": 220, "count7": 61 }, { "id": 123, "name": "eBook Reader", "type": "category", "countAll": 670, "count30": 10, "count7": 5 }, { "id": 124, "name": "Grill", "type": "category", "countAll": 1585, "count30": 60, "count7": 16 }, { "id": 125, "name": "External HD", "type": "category", "countAll": 2588, "count30": 58, "count7": 9 }, { "id": 126, "name": "Wine", "type": "category", "countAll": 1178, "count30": 34, "count7": 6 }, { "id": 127, "name": "Swimwear", "type": "category", "countAll": 1285, "count30": 78, "count7": 17 }, { "id": 128, "name": "Flight", "type": "category", "countAll": 4561, "count30": 162, "count7": 39 }, { "id": 129, "name": "Stereo Headset", "type": "category", "countAll": 1714, "count30": 47, "count7": 16 }, { "id": 130, "name": "Car", "type": "category", "countAll": 4405, "count30": 110, "count7": 31 }, { "id": 131, "name": "Knife", "type": "category", "countAll": 1696, "count30": 43, "count7": 8 }, { "id": 132, "name": "Movie", "type": "category", "countAll": 4222, "count30": 124, "count7": 35 }, { "id": 134, "name": "Receiver", "type": "category", "countAll": 3505, "count30": 78, "count7": 21 }, { "id": 135, "name": "Mattress", "type": "category", "countAll": 868, "count30": 39, "count7": 13 }, { "id": 136, "name": "Wireless Router", "type": "category", "countAll": 2720, "count30": 85, "count7": 25 }, { "id": 137, "name": "Refrigerator", "type": "category", "countAll": 654, "count30": 28, "count7": 8 }, { "id": 139, "name": "Compressor", "type": "category", "countAll": 239, "count30": 8, "count7": 1 }, { "id": 140, "name": "TV Series", "type": "category", "countAll": 971, "count30": 24, "count7": 3 }, { "id": 141, "name": "Backpack", "type": "category", "countAll": 1811, "count30": 102, "count7": 36 }, { "id": 143, "name": "MP3 Song", "type": "category", "countAll": 2026, "count30": 66, "count7": 18 }, { "id": 144, "name": "MP3 Player", "type": "category", "countAll": 1513, "count30": 26, "count7": 5 }, { "id": 145, "name": "Tripod", "type": "category", "countAll": 544, "count30": 13, "count7": 2 }, { "id": 146, "name": "Pens, Pencils & Markers", "type": "category", "countAll": 1547, "count30": 48, "count7": 24 }, { "id": 147, "name": "Umbrella", "type": "category", "countAll": 510, "count30": 35, "count7": 11 }, { "id": 148, "name": "Pillow", "type": "category", "countAll": 1304, "count30": 48, "count7": 13 }, { "id": 149, "name": "Vacuum", "type": "category", "countAll": 1611, "count30": 48, "count7": 16 }, { "id": 151, "name": "Sandal", "type": "category", "countAll": 1887, "count30": 102, "count7": 28 }, { "id": 152, "name": "Gift Card", "type": "category", "countAll": 7710, "count30": 260, "count7": 76 }, { "id": 153, "name": "Hotel", "type": "category", "countAll": 4858, "count30": 243, "count7": 65 }, { "id": 154, "name": "DVD", "type": "category", "countAll": 3535, "count30": 48, "count7": 3 }, { "id": 156, "name": "Server", "type": "category", "countAll": 794, "count30": 17, "count7": 6 }, { "id": 158, "name": "Remote", "type": "category", "countAll": 2656, "count30": 70, "count7": 13 }, { "id": 160, "name": "DVD Disc", "type": "category", "countAll": 770, "count30": 8, "count7": 3 }, { "id": 161, "name": "Desk", "type": "category", "countAll": 1259, "count30": 33, "count7": 14 }, { "id": 165, "name": "Messenger Bag", "type": "category", "countAll": 553, "count30": 11, "count7": 1 }, { "id": 166, "name": "Tent", "type": "category", "countAll": 455, "count30": 13, "count7": 4 }, { "id": 167, "name": "Android", "type": "category", "countAll": 5846, "count30": 293, "count7": 75 }, { "id": 173, "name": "Candy", "type": "category", "countAll": 1268, "count30": 40, "count7": 9 }, { "id": 175, "name": "Prescription Drug", "type": "category", "countAll": 582, "count30": 10, "count7": 3 } ] }
|