I Need a Bargain
  • Home
  • Bargain Boutique
    • Prescription Drugs
    • Printable Coupons >
      • Coupons.com
      • CouponNetwork.com
    • Reward Credit Cards
  • Blog
API HOME
GET categories
GET deals
GET promotypes
GET search
GET stores
GET tags

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


Need more help?

For API feature request, bug report, or any feedback related to API, please email team [at] ineedabargain.com.
© 2010-2019 I Need a Bargain
Home | About | Privacy Policy