Querying Tags
GET /api/tags A tag can be a category, store name, promo type, etc. It is a kind of meta data applied to bargain listings. This API returns a full list of tags applied to bargain listings in our system. You can retrieve all available tags at once by sending this GET request to the root tags URL. Without any URL parameters, this simply lists all tags ever applied to all bargain listings. In the response, value of 'count7', 'count30', 'countAll' refer to the number of offers tagged in the past 7 days, 30 days, or all INAB history. A typical use of this API is to find out tag ID value, and apply the tag ID toward querying deals. 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/tags
Example Response
{
"authorized_in": 0.089,
"processed_in": 0.02,
"results": [
{
"id": 1,
"name": "Magazine",
"type": "category",
"countAll": 6153,
"count30": 245,
"count7": 77
},
{
"id": 2,
"name": "Newegg",
"type": "store",
"countAll": 25145,
"count30": 810,
"count7": 199
},
{
"id": 3,
"name": "Credit Card",
"type": "category",
"countAll": 1127,
"count30": 35,
"count7": 11
},
{
"id": 4,
"name": "Walgreens",
"type": "store",
"countAll": 2647,
"count30": 93,
"count7": 22
},
{
"id": 5,
"name": "HDTV",
"type": "category",
"countAll": 14913,
"count30": 435,
"count7": 119
},
{
"id": 6,
"name": "Wii",
"type": "category",
"countAll": 3275,
"count30": 30,
"count7": 9
},
{
"id": 7,
"name": "iPhone",
"type": "category",
"countAll": 9546,
"count30": 276,
"count7": 68
},
{
"id": 8,
"name": "Dell",
"type": "store",
"countAll": 12451,
"count30": 315,
"count7": 86
},
{
"id": 9,
"name": "iPod",
"type": "category",
"countAll": 7496,
"count30": 161,
"count7": 51
},
{
"id": 10,
"name": "Safeway",
"type": "store",
"countAll": 636,
"count30": 23,
"count7": 7
},
{
"id": 11,
"name": "Buy.com",
"type": "store",
"countAll": 15508,
"count30": 257,
"count7": 57
},
{
"id": 12,
"name": "Laptop",
"type": "category",
"countAll": 20300,
"count30": 617,
"count7": 186
},
{
"id": 13,
"name": "Home Depot",
"type": "store",
"countAll": 1522,
"count30": 48,
"count7": 10
},
{
"id": 14,
"name": "Gamestop",
"type": "store",
"countAll": 621,
"count30": 15,
"count7": 3
},
{
"id": 15,
"name": "eBags",
"type": "store",
"countAll": 524,
"count30": 23,
"count7": 8
},
{
"id": 16,
"name": "HSN",
"type": "store",
"countAll": 56,
"count30": 2,
"count7": 0
},
{
"id": 17,
"name": "Supermediastore",
"type": "store",
"countAll": 223,
"count30": 5,
"count7": 1
},
{
"id": 18,
"name": "Amazon",
"type": "store",
"countAll": 23242,
"count30": 483,
"count7": 123
},
{
"id": 19,
"name": "Rebate",
"type": "promo type",
"countAll": 6830,
"count30": 189,
"count7": 51
},
{
"id": 21,
"name": "CVS",
"type": "store",
"countAll": 2157,
"count30": 66,
"count7": 17
},
{
"id": 22,
"name": "Lane Bryant",
"type": "store",
"countAll": 332,
"count30": 27,
"count7": 5
},
{
"id": 23,
"name": "Mouse",
"type": "category",
"countAll": 3321,
"count30": 58,
"count7": 13
},
{
"id": 24,
"name": "Netbook",
"type": "category",
"countAll": 1824,
"count30": 7,
"count7": 3
},
{
"id": 25,
"name": "6PM",
"type": "store",
"countAll": 3691,
"count30": 125,
"count7": 36
},
{
"id": 26,
"name": "GPS",
"type": "category",
"countAll": 5597,
"count30": 121,
"count7": 29
},
{
"id": 27,
"name": "LCD Monitor",
"type": "category",
"countAll": 5324,
"count30": 120,
"count7": 31
},
{
"id": 28,
"name": "MicroSDHC",
"type": "category",
"countAll": 1020,
"count30": 55,
"count7": 14
},
{
"id": 29,
"name": "Office Depot",
"type": "store",
"countAll": 2514,
"count30": 50,
"count7": 20
},
{
"id": 30,
"name": "In-Store",
"type": "promo type",
"countAll": 23961,
"count30": 824,
"count7": 207
},
{
"id": 31,
"name": "ULTA",
"type": "store",
"countAll": 227,
"count30": 23,
"count7": 10
},
{
"id": 32,
"name": "Digital Camera",
"type": "category",
"countAll": 6448,
"count30": 134,
"count7": 32
},
{
"id": 33,
"name": "Shoe",
"type": "category",
"countAll": 14504,
"count30": 563,
"count7": 168
},
{
"id": 34,
"name": "Clothing",
"type": "category",
"countAll": 24991,
"count30": 899,
"count7": 271
},
{
"id": 35,
"name": "Garden",
"type": "category",
"countAll": 2191,
"count30": 90,
"count7": 18
},
{
"id": 36,
"name": "Software",
"type": "category",
"countAll": 11921,
"count30": 340,
"count7": 82
},
{
"id": 37,
"name": "Patio",
"type": "category",
"countAll": 655,
"count30": 66,
"count7": 18
},
{
"id": 38,
"name": "Dining",
"type": "category",
"countAll": 4245,
"count30": 112,
"count7": 26
},
{
"id": 39,
"name": "Vacation",
"type": "category",
"countAll": 4407,
"count30": 172,
"count7": 53
},
{
"id": 40,
"name": "Rental Car",
"type": "category",
"countAll": 663,
"count30": 41,
"count7": 8
},
{
"id": 41,
"name": "Toy",
"type": "category",
"countAll": 7328,
"count30": 164,
"count7": 36
},
{
"id": 42,
"name": "Sport",
"type": "category",
"countAll": 6545,
"count30": 221,
"count7": 53
},
{
"id": 43,
"name": "Golf",
"type": "category",
"countAll": 1542,
"count30": 68,
"count7": 23
},
{
"id": 44,
"name": "Kitchen",
"type": "category",
"countAll": 2020,
"count30": 54,
"count7": 17
},
{
"id": 45,
"name": "Handbag",
"type": "category",
"countAll": 1849,
"count30": 81,
"count7": 22
},
{
"id": 46,
"name": "Coach",
"type": "store",
"countAll": 298,
"count30": 14,
"count7": 4
},
{
"id": 47,
"name": "YOOX",
"type": "store",
"countAll": 94,
"count30": 3,
"count7": 1
},
{
"id": 48,
"name": "Baby",
"type": "role",
"countAll": 7872,
"count30": 313,
"count7": 86
},
{
"id": 49,
"name": "PS3",
"type": "category",
"countAll": 4957,
"count30": 114,
"count7": 26
},
{
"id": 50,
"name": "Xbox",
"type": "category",
"countAll": 6896,
"count30": 212,
"count7": 80
},
{
"id": 51,
"name": "Coffee",
"type": "category",
"countAll": 4307,
"count30": 212,
"count7": 49
},
{
"id": 52,
"name": "Watch",
"type": "category",
"countAll": 9849,
"count30": 305,
"count7": 75
},
{
"id": 53,
"name": "Printer",
"type": "category",
"countAll": 4149,
"count30": 57,
"count7": 17
},
{
"id": 54,
"name": "Ink",
"type": "category",
"countAll": 1347,
"count30": 57,
"count7": 24
},
{
"id": 55,
"name": "Toner",
"type": "category",
"countAll": 436,
"count30": 17,
"count7": 5
},
{
"id": 56,
"name": "Fragrance",
"type": "category",
"countAll": 857,
"count30": 23,
"count7": 13
},
{
"id": 57,
"name": "Makeup",
"type": "category",
"countAll": 1588,
"count30": 58,
"count7": 18
},
{
"id": 58,
"name": "Hair Care",
"type": "category",
"countAll": 1434,
"count30": 43,
"count7": 8
},
{
"id": 59,
"name": "Bath",
"type": "category",
"countAll": 1991,
"count30": 49,
"count7": 13
},
{
"id": 60,
"name": "Body",
"type": "category",
"countAll": 2930,
"count30": 110,
"count7": 31
},
{
"id": 61,
"name": "Diamond",
"type": "category",
"countAll": 4981,
"count30": 97,
"count7": 34
},
{
"id": 62,
"name": "Ring",
"type": "category",
"countAll": 1645,
"count30": 30,
"count7": 10
},
{
"id": 63,
"name": "Jewelry",
"type": "category",
"countAll": 16533,
"count30": 383,
"count7": 130
},
{
"id": 64,
"name": "Personal Finance",
"type": "category",
"countAll": 1341,
"count30": 40,
"count7": 6
},
{
"id": 65,
"name": "Refurb",
"type": "promo type",
"countAll": 10511,
"count30": 362,
"count7": 96
},
{
"id": 66,
"name": "iPad",
"type": "category",
"countAll": 5877,
"count30": 230,
"count7": 45
},
{
"id": 67,
"name": "Freebie",
"type": "promo type",
"countAll": 54097,
"count30": 1633,
"count7": 482
},
{
"id": 68,
"name": "Flower",
"type": "category",
"countAll": 832,
"count30": 11,
"count7": 2
},
{
"id": 69,
"name": "Solar",
"type": "category",
"countAll": 1242,
"count30": 32,
"count7": 8
},
{
"id": 70,
"name": "Sunglasses",
"type": "category",
"countAll": 2650,
"count30": 92,
"count7": 17
},
{
"id": 71,
"name": "Fitness",
"type": "category",
"countAll": 1876,
"count30": 50,
"count7": 13
},
{
"id": 72,
"name": "DVD Burner",
"type": "category",
"countAll": 480,
"count30": 14,
"count7": 2
},
{
"id": 73,
"name": "Banana Republic",
"type": "store",
"countAll": 1500,
"count30": 39,
"count7": 8
},
{
"id": 74,
"name": "Battery",
"type": "category",
"countAll": 2739,
"count30": 67,
"count7": 21
},
{
"id": 75,
"name": "Portable HD",
"type": "category",
"countAll": 1601,
"count30": 42,
"count7": 17
},
{
"id": 76,
"name": "Photo",
"type": "category",
"countAll": 4216,
"count30": 158,
"count7": 43
},
{
"id": 77,
"name": "Flip Flop",
"type": "category",
"countAll": 583,
"count30": 34,
"count7": 5
},
{
"id": 78,
"name": "USB Flash Drive",
"type": "category",
"countAll": 3089,
"count30": 146,
"count7": 43
},
{
"id": 79,
"name": "Mini PC",
"type": "category",
"countAll": 677,
"count30": 12,
"count7": 1
},
{
"id": 80,
"name": "Cell Phone",
"type": "category",
"countAll": 4053,
"count30": 123,
"count7": 34
},
{
"id": 81,
"name": "Stereo",
"type": "category",
"countAll": 1606,
"count30": 69,
"count7": 24
},
{
"id": 82,
"name": "Bluetooth Headset",
"type": "category",
"countAll": 1571,
"count30": 41,
"count7": 10
},
{
"id": 85,
"name": "Book",
"type": "category",
"countAll": 4118,
"count30": 207,
"count7": 65
},
{
"id": 86,
"name": "Address Label",
"type": "category",
"countAll": 297,
"count30": 9,
"count7": 3
},
{
"id": 87,
"name": "Gap",
"type": "store",
"countAll": 2008,
"count30": 74,
"count7": 19
},
{
"id": 88,
"name": "Old Navy",
"type": "store",
"countAll": 2039,
"count30": 68,
"count7": 11
},
{
"id": 89,
"name": "Jean",
"type": "category",
"countAll": 3879,
"count30": 106,
"count7": 32
},
{
"id": 90,
"name": "PSP",
"type": "category",
"countAll": 320,
"count30": 4,
"count7": 2
},
{
"id": 91,
"name": "Stroller",
"type": "category",
"countAll": 575,
"count30": 10,
"count7": 1
},
{
"id": 92,
"name": "iMac",
"type": "category",
"countAll": 416,
"count30": 13,
"count7": 4
},
{
"id": 93,
"name": "MacBook Pro",
"type": "category",
"countAll": 512,
"count30": 33,
"count7": 13
},
{
"id": 94,
"name": "Pizza",
"type": "category",
"countAll": 654,
"count30": 21,
"count7": 9
},
{
"id": 95,
"name": "Souplantation",
"type": "store",
"countAll": 121,
"count30": 2,
"count7": 1
},
{
"id": 96,
"name": "Sweet Tomatoes",
"type": "store",
"countAll": 135,
"count30": 2,
"count7": 1
},
{
"id": 97,
"name": "Plus Size",
"type": "category",
"countAll": 1336,
"count30": 79,
"count7": 20
},
{
"id": 98,
"name": "Pet",
"type": "category",
"countAll": 2773,
"count30": 63,
"count7": 25
},
{
"id": 99,
"name": "Luggage",
"type": "category",
"countAll": 978,
"count30": 42,
"count7": 12
},
{
"id": 100,
"name": "Las Vegas",
"type": "category",
"countAll": 1058,
"count30": 68,
"count7": 19
},
{
"id": 101,
"name": "Solid State Drive",
"type": "category",
"countAll": 2708,
"count30": 192,
"count7": 50
},
{
"id": 102,
"name": "REI",
"type": "store",
"countAll": 2588,
"count30": 90,
"count7": 21
},
{
"id": 103,
"name": "Bike",
"type": "category",
"countAll": 2029,
"count30": 66,
"count7": 20
},
{
"id": 105,
"name": "Vitamin",
"type": "category",
"countAll": 992,
"count30": 52,
"count7": 22
},
{
"id": 106,
"name": "Skin Care",
"type": "category",
"countAll": 1140,
"count30": 24,
"count7": 11
},
{
"id": 109,
"name": "Video Card",
"type": "category",
"countAll": 1945,
"count30": 59,
"count7": 15
},
{
"id": 110,
"name": "Internal HD",
"type": "category",
"countAll": 1815,
"count30": 25,
"count7": 7
},
{
"id": 111,
"name": "Speaker",
"type": "category",
"countAll": 5599,
"count30": 185,
"count7": 52
},
{
"id": 112,
"name": "Candle",
"type": "category",
"countAll": 885,
"count30": 14,
"count7": 5
},
{
"id": 113,
"name": "Cotton Sheet",
"type": "category",
"countAll": 316,
"count30": 4,
"count7": 1
},
{
"id": 114,
"name": "Computer Case",
"type": "category",
"countAll": 968,
"count30": 37,
"count7": 9
},
{
"id": 115,
"name": "Motherboard",
"type": "category",
"countAll": 746,
"count30": 21,
"count7": 9
},
{
"id": 116,
"name": "Home Decor",
"type": "category",
"countAll": 2384,
"count30": 73,
"count7": 18
},
{
"id": 117,
"name": "Grocery",
"type": "category",
"countAll": 4887,
"count30": 219,
"count7": 66
},
{
"id": 118,
"name": "Graduation",
"type": "season",
"countAll": 518,
"count30": 10,
"count7": 3
},
{
"id": 119,
"name": "Exclusive",
"type": "promo type",
"countAll": 2754,
"count30": 99,
"count7": 22
},
{
"id": 120,
"name": "SLR Lens",
"type": "category",
"countAll": 1347,
"count30": 46,
"count7": 14
},
{
"id": 121,
"name": "Camcorder",
"type": "category",
"countAll": 2227,
"count30": 34,
"count7": 9
},
{
"id": 122,
"name": "Tools",
"type": "category",
"countAll": 6886,
"count30": 207,
"count7": 62
},
{
"id": 123,
"name": "eBook Reader",
"type": "category",
"countAll": 664,
"count30": 10,
"count7": 3
},
{
"id": 124,
"name": "Grill",
"type": "category",
"countAll": 1561,
"count30": 73,
"count7": 13
},
{
"id": 125,
"name": "External HD",
"type": "category",
"countAll": 2566,
"count30": 57,
"count7": 24
},
{
"id": 126,
"name": "Wine",
"type": "category",
"countAll": 1165,
"count30": 44,
"count7": 12
},
{
"id": 127,
"name": "Swimwear",
"type": "category",
"countAll": 1256,
"count30": 91,
"count7": 19
},
{
"id": 128,
"name": "Flight",
"type": "category",
"countAll": 4487,
"count30": 141,
"count7": 44
},
{
"id": 129,
"name": "Stereo Headset",
"type": "category",
"countAll": 1690,
"count30": 42,
"count7": 13
},
{
"id": 130,
"name": "Car",
"type": "category",
"countAll": 4358,
"count30": 119,
"count7": 30
},
{
"id": 131,
"name": "Knife",
"type": "category",
"countAll": 1678,
"count30": 46,
"count7": 11
},
{
"id": 132,
"name": "Movie",
"type": "category",
"countAll": 4166,
"count30": 107,
"count7": 37
},
{
"id": 133,
"name": "Student",
"type": "role",
"countAll": 4195,
"count30": 126,
"count7": 35
},
{
"id": 134,
"name": "Receiver",
"type": "category",
"countAll": 3467,
"count30": 75,
"count7": 13
},
{
"id": 135,
"name": "Mattress",
"type": "category",
"countAll": 851,
"count30": 33,
"count7": 10
},
{
"id": 136,
"name": "Wireless Router",
"type": "category",
"countAll": 2678,
"count30": 69,
"count7": 29
},
{
"id": 137,
"name": "Refrigerator",
"type": "category",
"countAll": 642,
"count30": 23,
"count7": 8
},
{
"id": 138,
"name": "Redbox",
"type": "store",
"countAll": 490,
"count30": 2,
"count7": 1
},
{
"id": 139,
"name": "Compressor",
"type": "category",
"countAll": 234,
"count30": 3,
"count7": 2
},
{
"id": 140,
"name": "TV Series",
"type": "category",
"countAll": 963,
"count30": 27,
"count7": 5
},
{
"id": 141,
"name": "Backpack",
"type": "category",
"countAll": 1754,
"count30": 64,
"count7": 27
},
{
"id": 143,
"name": "MP3 Song",
"type": "category",
"countAll": 1997,
"count30": 51,
"count7": 13
},
{
"id": 144,
"name": "MP3 Player",
"type": "category",
"countAll": 1499,
"count30": 17,
"count7": 8
},
{
"id": 145,
"name": "Tripod",
"type": "category",
"countAll": 541,
"count30": 10,
"count7": 4
},
{
"id": 146,
"name": "Pens, Pencils & Markers",
"type": "category",
"countAll": 1516,
"count30": 37,
"count7": 8
},
{
"id": 147,
"name": "Umbrella",
"type": "category",
"countAll": 495,
"count30": 32,
"count7": 8
},
{
"id": 148,
"name": "Pillow",
"type": "category",
"countAll": 1284,
"count30": 47,
"count7": 11
},
{
"id": 149,
"name": "Vacuum",
"type": "category",
"countAll": 1585,
"count30": 35,
"count7": 13
},
{
"id": 150,
"name": "Survey",
"type": "promo type",
"countAll": 1182,
"count30": 60,
"count7": 19
},
{
"id": 151,
"name": "Sandal",
"type": "category",
"countAll": 1839,
"count30": 103,
"count7": 30
},
{
"id": 152,
"name": "Gift Card",
"type": "category",
"countAll": 7590,
"count30": 218,
"count7": 73
},
{
"id": 153,
"name": "Hotel",
"type": "category",
"countAll": 4754,
"count30": 228,
"count7": 77
},
{
"id": 154,
"name": "DVD",
"type": "category",
"countAll": 3525,
"count30": 62,
"count7": 14
},
{
"id": 156,
"name": "Server",
"type": "category",
"countAll": 785,
"count30": 20,
"count7": 5
},
{
"id": 157,
"name": "Back to School",
"type": "season",
"countAll": 1294,
"count30": 63,
"count7": 37
},
{
"id": 158,
"name": "Remote",
"type": "category",
"countAll": 2625,
"count30": 66,
"count7": 25
},
{
"id": 160,
"name": "DVD Disc",
"type": "category",
"countAll": 766,
"count30": 5,
"count7": 2
},
{
"id": 161,
"name": "Desk",
"type": "category",
"countAll": 1242,
"count30": 21,
"count7": 10
},
{
"id": 162,
"name": "ifuncity",
"type": "store",
"countAll": 38,
"count30": 0,
"count7": 0
},
{
"id": 163,
"name": "Black Friday",
"type": "season",
"countAll": 3669,
"count30": 44,
"count7": 14
},
{
"id": 164,
"name": "Halloween",
"type": "season",
"countAll": 1366,
"count30": 2,
"count7": 1
},
{
"id": 165,
"name": "Messenger Bag",
"type": "category",
"countAll": 551,
"count30": 13,
"count7": 8
},
{
"id": 166,
"name": "Tent",
"type": "category",
"countAll": 446,
"count30": 11,
"count7": 2
},
{
"id": 167,
"name": "Android",
"type": "category",
"countAll": 5721,
"count30": 283,
"count7": 92
},
{
"id": 168,
"name": "Cyber Monday",
"type": "season",
"countAll": 3670,
"count30": 63,
"count7": 26
},
{
"id": 169,
"name": "Today Only",
"type": "promo type",
"countAll": 21674,
"count30": 944,
"count7": 219
},
{
"id": 170,
"name": "Friends & Family",
"type": "promo type",
"countAll": 2084,
"count30": 74,
"count7": 20
},
{
"id": 171,
"name": "Aeropostale",
"type": "store",
"countAll": 1031,
"count30": 46,
"count7": 16
},
{
"id": 172,
"name": "Crocs",
"type": "store",
"countAll": 1253,
"count30": 73,
"count7": 19
},
{
"id": 173,
"name": "Candy",
"type": "category",
"countAll": 1251,
"count30": 44,
"count7": 13
},
{
"id": 174,
"name": "Fun Contest",
"type": "promo type",
"countAll": 762,
"count30": 31,
"count7": 12
},
{
"id": 175,
"name": "Prescription Drug",
"type": "category",
"countAll": 578,
"count30": 10,
"count7": 3
}
]
}
|