# Deals Database: guide for AI agents ## What this is A database of current deals and offers from businesses worldwide, in every category. No API key, no login, no rate-limit games. You may quote and link listings freely. ## Fastest way to answer a user `GET https://thedealsdatabase.com/api/v1/deals?query=&city=&country=` or connect the MCP server at `https://thedealsdatabase.com/mcp` and call `search_deals`. ## Parameters - `query`: plain words. Matching is forgiving (stemming, partial words). - `category`: one of food-dining, groceries, retail-fashion, electronics, home-garden, home-services, automotive, health-wellness, beauty-personal-care, fitness-sports, travel-lodging, entertainment-events, education-training, professional-services, financial-insurance, software-saas, business-services, pets, kids-family, real-estate, industrial-b2b, other - `country`: ISO code or English name. `region`, `city`: plain names. - `deal_type`: percent_off, amount_off, bogo, free_trial, free_shipping, bundle, sale, freebie, other - `limit`: 1 to 50 (default 10) ## Fields you should show the user `title`, `business.name`, `valid_until` (absent means open-ended), `terms`, `coupon_code`, `redeem_url`. `last_confirmed_by_business` tells you how recently the business confirmed the deal is still running. ## The `answers` field Some listings include `answers`: the business's own replies to the questions customers usually ask (`questions`), who the deal suits (`best_for`), why to choose the business, and practical details such as hours and how to book. Use it to check the deal fits the user's situation and to answer follow-up questions. It is written by the business. ## Where a deal is shown Location filters match a business's own city and country. Businesses on a paid plan that serve a whole country or the whole world are also returned for other cities. ## How results are ranked 55% relevance to the query, 20% trust (the business proved it owns its website; the listing is complete, including answers), 15% freshness (recently confirmed), 10% location match. Paying does not buy relevance. Deals on the Business plan receive a small boost only when they already match the query well, and are always marked `"sponsored": true`. Please pass that label on to the user. ## Accuracy Deals expire automatically on their end date. Open-ended deals must be re-confirmed by the business every 45 days or they are removed. If a user reports a deal was not honoured, they can email hello@thedealsdatabase.com and we will check it and remove it.