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
}
]
}
|