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 Deals


GET /api/deals

Return recently published bargain deals of all or of a specified tag. To limit returned bargains to a specific tag, you first need to know what tag_id to pass into this API by refer to GET tags API. A tag can be a category, store name, promo type, etc. The returned bargain deals will be sorted with the most recently published offers come first.

A typical use of this API is to find out the discount offers of a given category, store name, or promo type.

Sample Requests
curl -X GET \
  -H "X-INAB-Application-Id: ${APPLICATION_ID}" \
  -H "X-INAB-REST-API-Key: ${REST_API_KEY}" \
  http://www.ineedabargain.com/api/deals

curl -X GET \
  -H "X-INAB-Application-Id: ${APPLICATION_ID}" \
  -H "X-INAB-REST-API-Key: ${REST_API_KEY}" \
  http://www.ineedabargain.com/api/deals?tag_id=1

curl -X GET \
  -H "X-INAB-Application-Id: ${APPLICATION_ID}" \
  -H "X-INAB-REST-API-Key: ${REST_API_KEY}" \
  http://www.ineedabargain.com/api/deals?tag_id=1\&skip=0\&limit=10
Paramters
tag_id (optional) Tag ID. The ID value of a tag. A tag can be a category, store name, promo type, etc. e.g. 1. If no tag_id parameter is given, this API will return bargains of all categories, most recently published displayed first.
limit (optional) Maximum number of bargains returned, can not exceed 1000. For pagination purposes, if you plan to display 10 deals per page, simply set 'limit' to 10. If not specified, default is 20.
skip (optional) Number of bargains skipped. For pagination purposes, if you'd like to get deals of the 2nd page, and you plan to display 10 deals per page, then you'd 'skip' the first 10 results by setting 'skip' to 10. If 'skip' is not specified, the default is 0, referring to the results of the 1st page.

Example Response
{
    "authorized_in": 0.296,
    "processed_in": 0.244,
    "tag_id": 1,
    "tag_name": "Magazine",
    "tag_type": "category",
    "tag_countAll": 9308,
    "tag_count30": 459,
    "tag_count7": 123,
    "limit": 20,
    "skip": 0,
    "exact_count": 9308,
    "results": [
        {
            "id": 932727,
            "title": "Recyclebank: Get a subscription All You magazine for 400 points!",
            "url": "http://www.ineedabargain.com/deals/show/932727/Recyclebank:-Get-a-subscription-All-You-magazine-for",
            "image": "http://www.ineedabargain.com/images/item/1/93/2727.jpg",
            "description": "I'm pretty excited because Recyclebank is offering a one-year subscription to All You magazine right now for just 400 points! Recyclebank has a number of opportunities to earn points on their site right now, and they are releasing opportunities to earn an additional 100 points each week. So if you haven't earned 400 points already, you should be able to earn them with within the next few weeks and cash in on this great reward.     Make 2013 your most disciplined, productive year ever! Get 21 Days to a More Disciplined Life today!       Recyclebank: Get a subscription All You magazine for 400 points! is a post from: Money Saving Mom        Comments Comments Related Stories Bruegger’s Bagels coupon: 3 free bagels on April 25, 2013 Free Gooseberry Patch Kid-Friendly Recipes booklet The best freebies from this past week   ",
            "source": "Money Saving Mom",
            "published_at": "2013-04-18 13:46:25 -0800"
        },
        {
            "id": 932714,
            "title": "All You Magazine Just $1 Per Issue",
            "url": "http://www.ineedabargain.com/deals/show/932714/All-You-Magazine-Just-$1-Per-Issue",
            "image": "http://www.ineedabargain.com/images/item/1/93/2714.jpg",
            "description": "   If you’ve been considering a subscription to All You Magazine, right now is a great time to try it out! Subscribe to All You for Just $1 an Issue for the next six months, which is a savings of $1.49 per issue, and a great price since this magazine very rarely goes on sale.   All You [...] You just finished reading All You Magazine Just $1 Per Issue ! Consider leaving a comment! The post All You Magazine Just $1 Per Issue appeared first on Passionate Penny Pincher . ",
            "source": "Passionate Penny Pincher",
            "published_at": "2013-04-18 13:38:08 -0800"
        },
        {
            "id": 932559,
            "title": "Bloomberg Businessweek Magazine 3-Year Subscription (162 issues) for $23",
            "url": "http://www.ineedabargain.com/deals/show/932559/Bloomberg-Businessweek-Magazine-3-Year-Subscription-(162-issues)-for",
            "image": "http://www.ineedabargain.com/images/item/1/93/2559.jpg",
            "description": " As one of its daily deals, DiscountMags offers a Bloomberg Businessweek Magazine 3-Year Subscription (162 issues) for $149.97. Coupon code \"DEALNEWS\" drops it to $23 . That's $0.14/issue, $2 under our mention from three weeks ago, and tied with last month's mention as the lowest price we've seen. (It's also $2 less than the best price we could find for a 1-year subscription elsewhere.) Deal ends today.",
            "source": "Dealnews",
            "published_at": "2013-04-18 11:28:25 -0800"
        },
        {
            "id": 932544,
            "title": "House Beautiful Magazine 1-Year Subscription (10 issues) for $5",
            "url": "http://www.ineedabargain.com/deals/show/932544/House-Beautiful-Magazine-1-Year-Subscription-(10-issues)-for",
            "image": "http://www.ineedabargain.com/images/item/1/93/2544.jpg",
            "description": " As one of it's daily deals, DiscountMags offers a House Beautiful Magazine 1-Year Subscription (10 issues) for $15. Coupon code \"DEALNEWS\" cuts it to $4.99 . That's tied with last month's expired mention and the lowest price we could find now by $10. Deal ends today.    Of note, you can purchase up to a 3-year subscription or renewal for this per-year price.  ",
            "source": "Dealnews",
            "published_at": "2013-04-18 10:37:48 -0800"
        },
        {
            "id": 932503,
            "title": "Maxim Magazine 1-Year Subscription (12 issues) for free",
            "url": "http://www.ineedabargain.com/deals/show/932503/Maxim-Magazine-1-Year-Subscription-(12-issues)-for-free",
            "image": "http://www.ineedabargain.com/images/item/1/93/2503.jpg",
            "description": " Freebizmag offers a Maxim Magazine 1-Year Subscription (12 issues) for free in exchange for information about you and your company. That's tied with our mention three weeks ago and a current price low now by $10.",
            "source": "Dealnews",
            "published_at": "2013-04-18 10:14:38 -0800"
        },
        {
            "id": 932484,
            "title": "Highlights - Save up to 67% off newsstand price on Highlights for Children Magazine subscriptions at Highlights",
            "url": "http://www.ineedabargain.com/deals/show/932484/Highlights---Save-up-to-67pct-off-newsstand",
            "image": "http://www.ineedabargain.com/images/item/1/93/2484.jpg",
            "description": " 		From Highlights - Save up to 67% off newsstand price on Highlights for Children Magazine subscriptions at Highlights. Offer expires on Fri, May 31st.		",
            "source": "Coupon Chief",
            "published_at": "2013-04-18 10:01:48 -0800"
        },
        {
            "id": 932508,
            "title": "Free Magazine Subscription ~ Shape",
            "url": "http://www.ineedabargain.com/deals/show/932508/Free-Magazine-Subscription-~-Shape",
            "image": "http://www.ineedabargain.com/images/item/1/93/2508.jpg",
            "description": " The post Free Magazine Subscription ~ Shape appeared first on Coupons | Freebies | Frugal | HEB Deals . Free Magazine Subscription ~ Shape ~ FREEBIE ALERT ~ Here is a free  subscription to Shape Magazine. This is a one year subscription. Do you want to know the latest info to keep or get in shape? This is the magazine for you if you answered yes. You will get info on diet, fitness, recipes and more. [...]    Related Stories Free Glasses ~ coastal.com Free Photo Canvas from Canvas People Free Sample ~ Olay Fresh Effects   ",
            "source": "Frugally Thrifty",
            "published_at": "2013-04-18 09:54:52 -0800"
        },
        {
            "id": 932447,
            "title": "1-Yr (12 issues) of Automobile Magazine Subscription only $4.25",
            "url": "http://www.ineedabargain.com/deals/show/932447/1-Yr-(12-issues)-of-Automobile-Magazine-Subscription-only",
            "image": "http://www.ineedabargain.com/images/item/1/93/2447.jpg",
            "description": " Super Hot ~ Exclusive Offer ~ Deal of the Day Compare : Amazon ($10.00) | MagazineLine.com ($10.00) | Magazines.com ($10.00) | Magazine-Agent ($10.00) Click here for complete deal detail and steps on how to get it. Share this deal with your friend/family by sending them this URL: http://www.edealinfo.com/d/00020130418162/1-Yr-12-issues-of-Automobile-Magazine-Subscription Checkout eDeal PC .com to find best deals on Laptop, Desktop, All-in-One & Sever configurations that YOU select directly from Dell, HP, Lenovo, Sony, Toshiba & Apple.  Click here to check it out. ",
            "source": "eDealInfo",
            "published_at": "2013-04-18 09:31:10 -0800"
        },
        {
            "id": 932207,
            "title": "Latina Magazine Subscription $3.99 (Today Only!)",
            "url": "http://www.ineedabargain.com/deals/show/932207/Latina-Magazine-Subscription-$3.99-(Today-Only!)",
            "image": "http://www.ineedabargain.com/images/no_image.jpg",
            "description": " This is a great price for a one-year subscription to Latina magazine, and you can order up to 2 years at this price! Order your subscription from Tanga.com for just $3.99 (reg. $30.00!) when you use Tanga promo code BABYSAVERS at checkout. This offer is valid starting on 4/18 at 10am EST for 24 hours only! The post Latina Magazine Subscription $3.99 (Today Only!) appeared first on Baby Savers! . ",
            "source": "Baby Savers",
            "published_at": "2013-04-18 06:00:44 -0800"
        },
        {
            "id": 932183,
            "title": "Free Download of The Old Schoolhouse Magazine (April 2013)",
            "url": "http://www.ineedabargain.com/deals/show/932183/Free-Download-of-The-Old-Schoolhouse-Magazine-(April",
            "image": "http://www.ineedabargain.com/images/item/1/93/2183.jpg",
            "description": "Homeschooling – thinking about it or just curious? You can download a FREE copy of The Old Schoolhouse Magazine right now! This is the April 2013 edition. You can still get a FREE download of the annual 2013 edition as well! Looking for more homeschool resources? Here are some more great deals currently available! FREE McGuffey Readers and [...] Free Download of The Old Schoolhouse Magazine (April 2013) is a post from Couponing 101  ",
            "source": "Couponing 101",
            "published_at": "2013-04-18 06:00:14 -0800"
        },
        {
            "id": 932128,
            "title": "Free From Scratch Homestead Magazine (online edition)",
            "url": "http://www.ineedabargain.com/deals/show/932128/Free-From-Scratch-Homestead-Magazine-(online-edition)",
            "image": "http://www.ineedabargain.com/images/item/1/93/2128.jpg",
            "description": "Download a free digital copy of the April/May From Scratch magazine.     Make 2013 your most disciplined, productive year ever! Get 21 Days to a More Disciplined Life today!       Free From Scratch Homestead Magazine (online edition) is a post from: Money Saving Mom     Related Stories Educational Freebie: If You Give a Mouse a Cookie Preschool Printable Pack Join Lysa TerKeurst & me for a FREE Live Webcast next Tuesday at 8 p.m. EST (April 23, 2013) Free Olay Fresh Effects sample   ",
            "source": "Money Saving Mom",
            "published_at": "2013-04-18 04:38:43 -0800"
        },
        {
            "id": 932056,
            "title": "House Beautiful magazine for only $4.99 per year",
            "url": "http://www.ineedabargain.com/deals/show/932056/House-Beautiful-magazine-for-only-$4.99-per-year",
            "image": "http://www.ineedabargain.com/images/item/1/93/2056.jpg",
            "description": "Right now, you can get a one-year subscription to House Beautiful Magazine for only $4.99 per year when you use coupon code MONEYSAVING at checkout. You can order up to three years at this price! About House Beautiful magazine: House Beautiful is written for affluent readers with a sense of style. It introduces possibilities in [...]     Make 2013 your most disciplined, productive year ever! Get 21 Days to a More Disciplined Life today!       House Beautiful magazine for only $4.99 per year is a post from: Money Saving Mom     Related Stories Amazon.com: The best online household & grocery deals this week One-year subscription to Woodcraft magazine for $6.49 Gluten-Free Coupons & Deals   ",
            "source": "Money Saving Mom",
            "published_at": "2013-04-18 03:59:43 -0800"
        },
        {
            "id": 932017,
            "title": "House Beautiful Magazine for $4.99 per Year",
            "url": "http://www.ineedabargain.com/deals/show/932017/House-Beautiful-Magazine-for-$4.99-per-Year",
            "image": "http://www.ineedabargain.com/images/no_image.jpg",
            "description": " Get a subscription to House Beautiful Magazine for $4.99 per year today April 18th! Use coupon code LUVABARGAIN at checkout. You can also get an additional 20% off ANY other magazine subscription you may want with the same coupon code. About House Beautiful Magazine: House Beautiful is written for affluent readers with a sense of [...] The post House Beautiful Magazine for $4.99 per Year appeared first on Luv a Bargain . Related posts: Family Handyman Magazine for $4.99 per Year Bon Appetit Magazine for $4.99 per Year Elle Magazine for $4.49 per Year ",
            "source": "Luv a Bargain",
            "published_at": "2013-04-18 03:36:42 -0800"
        },
        {
            "id": 932008,
            "title": "Good Deal: AUTOWEEK Magazine Subscription $3.39 TODAY ONLY!",
            "url": "http://www.ineedabargain.com/deals/show/932008/Good-Deal:-AUTOWEEK-Magazine-Subscription-$3.39-TODAY-ONLY!",
            "image": "http://www.ineedabargain.com/images/no_image.jpg",
            "description": "Today only, 4-18-13, a one year subscription to AUTOWEEK magazine is $3.99. If you use code: GEORGINESAVES at checkout you will pay only $3.39. Each issue is for the auto enthusiast who can’t wait for current news on all things auto. It features real-world vehicle tests, industry news and trends, product evaluations, new model information, race [...]",
            "source": "Georgine Saves",
            "published_at": "2013-04-18 03:24:17 -0800"
        },
        {
            "id": 931947,
            "title": "1-Yr (10 Issues) of House Beautiful Magazine Subscription only $4.99",
            "url": "http://www.ineedabargain.com/deals/show/931947/1-Yr-(10-Issues)-of-House-Beautiful-Magazine-Subscription",
            "image": "http://www.ineedabargain.com/images/item/1/93/1947.jpg",
            "description": " Super Hot ~ Huge Exclusive Coupon Offer ~ Expires Today Compare : HSN.com ($17.20) | Magsconnect. ($19.99) | MagMall ($20.00) | Magazines ($19.99) Click here for complete deal detail and steps on how to get it. Share this deal with your friend/family by sending them this URL: http://www.edealinfo.com/d/00020130110005/1-Yr-10-Issues-of-House-Beautiful-Magazine-Subscription Checkout eDeal PC .com to find best deals on Laptop, Desktop, All-in-One & Sever configurations that YOU select directly from Dell, HP, Lenovo, Sony, Toshiba & Apple.  Click here to check it out. ",
            "source": "eDealInfo",
            "published_at": "2013-04-18 02:01:12 -0800"
        },
        {
            "id": 931899,
            "title": "1-Year (26 Issues) of Autoweek Magazine Subscription only $3.35",
            "url": "http://www.ineedabargain.com/deals/show/931899/1-Year-(26-Issues)-of-Autoweek-Magazine-Subscription-only",
            "image": "http://www.ineedabargain.com/images/item/1/93/1899.jpg",
            "description": " Super Hot ~ Deal of the Day Compare : Magazine-Agent ($19.95) | MagMall ($20.00) | Magazines ($20.00) | Magazines Unlimited ($20.00) Click here for complete deal detail and steps on how to get it. Share this deal with your friend/family by sending them this URL: http://www.edealinfo.com/d/00020121218020/1-Year-26-Issues-of-Autoweek-Magazine-Subscription Checkout eDeal PC .com to find best deals on Laptop, Desktop, All-in-One & Sever configurations that YOU select directly from Dell, HP, Lenovo, Sony, Toshiba & Apple.  Click here to check it out. ",
            "source": "eDealInfo",
            "published_at": "2013-04-18 01:00:52 -0800"
        },
        {
            "id": 931727,
            "title": "The Atlantic Magazine 1-Year Subscription (10 issues) for $5",
            "url": "http://www.ineedabargain.com/deals/show/931727/The-Atlantic-Magazine-1-Year-Subscription-(10-issues)-for",
            "image": "http://www.ineedabargain.com/images/item/1/93/1727.jpg",
            "description": " DiscountMags offers The Atlantic Magazine 1-Year Subscription (10 issues) for $23.99. Coupon code \"DEALNEWS\" knocks it to $4.50 . That's 50 cents under our mention from four days ago and the lowest price we could find by $3. Deal ends April 18 at 10 am ET.    Of note, you can purchase up to a 3-year subscription at this per-year price.  ",
            "source": "Dealnews",
            "published_at": "2013-04-17 18:42:59 -0800"
        },
        {
            "id": 931701,
            "title": "Family Handyman Magazine 4-Year Subscription (44 issues) for $20",
            "url": "http://www.ineedabargain.com/deals/show/931701/Family-Handyman-Magazine-4-Year-Subscription-(44-issues)-for",
            "image": "http://www.ineedabargain.com/images/item/1/93/1701.jpg",
            "description": " DiscountMags offers a Family Handyman Magazine 1-Year Subscription (44 issues) for $79.88. Coupon code \"DEALNEWS\" cuts it to $19.96 . That's tied with our mention from four days ago and the best price we could find now by $20.    Of note, you can purchase a single year subscriptions for $4.99/year.  ",
            "source": "Dealnews",
            "published_at": "2013-04-17 17:42:59 -0800"
        },
        {
            "id": 931646,
            "title": "Woodcraft Magazine ($5.36 compare at $19.97) @ Best Deal Magazines",
            "url": "http://www.ineedabargain.com/deals/show/931646/Woodcraft-Magazine-($5.36-compare-at-$19.97)-@-Best",
            "image": "http://www.ineedabargain.com/images/item/1/93/1646.jpg",
            "description": " ",
            "source": "Fatwallet",
            "published_at": "2013-04-17 16:07:24 -0800"
        },
        {
            "id": 931656,
            "title": "Bon Appetit Magazine 1-Year Subscription (12 issues) for $5",
            "url": "http://www.ineedabargain.com/deals/show/931656/Bon-Appetit-Magazine-1-Year-Subscription-(12-issues)-for",
            "image": "http://www.ineedabargain.com/images/item/1/93/1656.jpg",
            "description": " As one of its daily deals, DiscountMags offers a Bon Appetit Magazine 1-Year Subscription (12 issues) for $15. Coupon code \"DEALNEWS\" knocks it to $4.99 . That's tied with our mention from a month ago and the lowest price we could find now by $9. Deal ends today.    Of note, you can purchase up to a 3-year subscription or renewal at this discounted annual rate.  ",
            "source": "Dealnews",
            "published_at": "2013-04-17 15:55:36 -0800"
        }
    ]
}


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