--- type: "firecrawl-provider" description: "DealSea (dealsea.com), an editor-curated US deals site: the latest deals, keyword deal search, deals by category, a store's coupon codes and sales, and single deal detail. Deals carry the headline price, store, quoted promo code, write-up and comment count; store pages list promo codes and sales with the site's expired flag and active counts." use_when: "DealSea (dealsea.com), an editor-curated US deals site: the latest deals, keyword deal search, deals by category, a store's coupon codes and sales, and single deal detail. Deals carry the headline price, store, quoted promo code, write-up and comment count; store pages list promo codes and sales with the site's expired flag and active counts." categories: "Retail" capabilities: 5 credits_per_call: 5 --- # DealSea on Firecrawl Alexandria DealSea (dealsea.com), an editor-curated US deals site: the latest deals, keyword deal search, deals by category, a store's coupon codes and sales, and single deal detail. Deals carry the headline price, store, quoted promo code, write-up and comment count; store pages list promo codes and sales with the site's expired flag and active counts. - Categories: Retail - Category index: [Retail category](https://alexandria.firecrawl.dev/agents/categories/retail) - Provider key: `dealsea-com` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/dealsea-com) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/dealsea-com/openapi.json) ## Capabilities - [Get deal](https://alexandria.firecrawl.dev/agents/providers/dealsea-com/deals/get_deal): One DealSea deal by id or URL: title, headline price, store and store domain, quoted promo code, full write-up, posting time and editor. - [Get store coupons](https://alexandria.firecrawl.dev/agents/providers/dealsea-com/deals/get_store_coupons): A store's coupon codes and sales on DealSea (its /view/ page): each offer's promo code (or null for sales), title, details and the site's Expired flag, plus the site's counts of active codes and sales. Expired offers are dropped unless include_expired is set. An unknown store is not_found. - [List category deals](https://alexandria.firecrawl.dev/agents/providers/dealsea-com/deals/list_category_deals): One DealSea category's deals (its //b?node= page), newest first, up to 50 per page. - [List deals](https://alexandria.firecrawl.dev/agents/providers/dealsea-com/deals/list_deals): DealSea's front page, newest first: one page of up to 50 deals with headline price, store, quoted promo code, write-up and comment count. - [Search deals](https://alexandria.firecrawl.dev/agents/providers/dealsea-com/deals/search_deals): Keyword search of DealSea deals, 10 per page with the site's total match count. A query with no matches returns an empty list. ## 1. Choose this provider when DealSea (dealsea.com), an editor-curated US deals site: the latest deals, keyword deal search, deals by category, a store's coupon codes and sales, and single deal detail. Deals carry the headline price, store, quoted promo code, write-up and comment count; store pages list promo codes and sales with the site's expired flag and active counts. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "dealsea-com", "capability": "deals/get_deal", "options": { "deal_id": "1998378" } } ``` ## 3. Add provider options Use only the options needed for the task: - `deal_id` (string): Deal id, the number in a /view-deal/ URL. Pattern: ^[0-9]+$. Example: `` - `url` (string): A dealsea.com/view-deal/ URL. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "dealsea-com", capability: "deals/get_deal", options: { deal_id: "1998378", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "dealsea-com", "capability": "deals/get_deal", "options": { "deal_id": "1998378" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "dealsea-com", "capability": "deals/get_deal", "options": { "deal_id": "1998378" } } }' ``` ### CLI ```sh firecrawl scrape 'dealsea-com/deals/get_deal' \ --options '{"deal_id":"1998378"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "dealsea-com", "capability": "deals/get_deal", "options": { "deal_id": "1998378" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "dealsea-com", "capability": "deals/get_deal", "options": { "deal_id": "1998378" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "coupon_code": null, "deal_id": "1998378", "description": "Amazon has Dyson V9 Motorbar Cordless Vacuum Cleaner for $269.99. Shipping is free. [Dyson]", "image_url": "https://i.dealsea.com/images/prod/26/11/1794338860.jpg", "observed_at_ms": 1794341309106, "posted_at": "2026-11-10T14:27:00-05:00", "posted_by": "cheetah", "posted_text": "Posted November 10, 2026 at 14:27 PM EST", "price": 269.99, "price_text": "$269.99", "store": "Amazon", "store_domain": "amazon.com", "title": "Dyson V9 Motorbar Cordless Vacuum Cleaner", "url": "https://dealsea.com/view-deal/1998378" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Get deal - Capability: `deals/get_deal` - Description: One DealSea deal by id or URL: title, headline price, store and store domain, quoted promo code, full write-up, posting time and editor. - Instructions: After a listing, or when the user pastes a dealsea.com/view-deal/ URL. - Cost: 5 credits per call - Capability file: [Get deal](https://alexandria.firecrawl.dev/agents/providers/dealsea-com/deals/get_deal) Accepted options: - `deal_id` (string): Deal id, the number in a /view-deal/ URL. Pattern: ^[0-9]+$. Example: `` - `url` (string): A dealsea.com/view-deal/ URL. Example: `` Response schema example: ```json { "coupon_code": null, "deal_id": "1998378", "description": "Amazon has Dyson V9 Motorbar Cordless Vacuum Cleaner for $269.99. Shipping is free. [Dyson]", "image_url": "https://i.dealsea.com/images/prod/26/11/1794338860.jpg", "observed_at_ms": 1794341309106, "posted_at": "2026-11-10T14:27:00-05:00", "posted_by": "cheetah", "posted_text": "Posted November 10, 2026 at 14:27 PM EST", "price": 269.99, "price_text": "$269.99", "store": "Amazon", "store_domain": "amazon.com", "title": "Dyson V9 Motorbar Cordless Vacuum Cleaner", "url": "https://dealsea.com/view-deal/1998378" } ``` ### Get store coupons - Capability: `deals/get_store_coupons` - Description: A store's coupon codes and sales on DealSea (its /view/ page): each offer's promo code (or null for sales), title, details and the site's Expired flag, plus the site's counts of active codes and sales. Expired offers are dropped unless include_expired is set. An unknown store is not_found. - Instructions: For promo codes or coupons at a named store. Pass the store's domain (woot.com, amazon.com, jcrew.com) or a pasted /view/ URL. - Cost: 5 credits per call - Capability file: [Get store coupons](https://alexandria.firecrawl.dev/agents/providers/dealsea-com/deals/get_store_coupons) Accepted options: - `include_expired` (boolean): Also return offers the site marks Expired. Example: `false` - `store` (string): Store domain as DealSea lists it, e.g. woot.com; a full store URL is reduced to its domain. Example: `` - `url` (string): A dealsea.com/view/ URL. Example: `` Response schema example: ```json { "active_counts": { "all": 9, "online_sales": 5, "promo_codes": 4 }, "count": 32, "coupons": [ { "code": "NOVDOLLARTEE", "description": "Cool Shirts to Welcome YOU to Woot! $1 for new customers", "expired": false, "kind": "code", "offer_id": "1997982", "title": "Cool Shirts to Welcome YOU to Woot! $1 for new customers" }, { "code": "WOOTJULY", "description": null, "expired": false, "kind": "code", "offer_id": "1990052", "title": "$10 Off Sitewide for New Customers. One use per user. Valid 6/28/26, 12am CT - 7/1, 11:59pm CT." }, { "code": "SLEEPFIVE", "description": null, "expired": false, "kind": "code", "offer_id": "1997983", "title": "Amazon Basics Sleeping Bag 35F for $14.99" }, { "code": null, "description": "Woot has Factory Reconditioned Ninja R-ES601 Luxe Café Premier Series Espresso Machine, Drip Coffee, Cold Brew, Grinder, Tamper, Frother for $249.99. Shipping is free with Prime. [amazon]", "expired": false, "kind": "deal", "offer_id": "1996785", "title": "Factory Reconditioned Ninja R-ES601 Luxe Café Premier Series Espresso Machine $249.99" } ], "include_expired": false, "observed_at_ms": 1794341308980, "source_url": "https://dealsea.com/view/woot.com", "store": "Woot", "store_domain": "woot.com" } ``` ### List category deals - Capability: `deals/list_category_deals` - Description: One DealSea category's deals (its //b?node= page), newest first, up to 50 per page. - Instructions: For deals in a product area (electronics, laptops, TVs, shoes, kitchen ...). Pass a category slug or a pasted category URL. - Cost: 5 credits per call - Capability file: [List category deals](https://alexandria.firecrawl.dev/agents/providers/dealsea-com/deals/list_category_deals) Accepted options: - `category` (string): Category slug from dealsea.com/categories. Example: `electronics` - `page` (number): 1-based page number. Example: `1` - `url` (string): A dealsea.com//b?node= URL. Example: `` Response schema example: ```json { "category": "electronics", "count": 50, "deals": [ { "comments_count": 0, "coupon_code": null, "deal_id": "1998371", "description": "Amazon has up to 65% off Amazon devices. Amazon Fire 7 Kids tablet + 6-Month Amazon Kids $49.99 Blink Outdoor XR+ and Battery Doorbell 2K+ 4 camera system + doorbell $122 Ring Wired Doorbell 2K Plus (Newest Model) $90 Amazon Fire TV Stick 4K (newest model) $25 More...", "image_url": "https://i.dealsea.com/images/prod/26/11/1794330085.jpg", "price": 50, "price_text": "$50 and more", "store": "Amazon", "title": "Amazon Devices Sale - Fire 7 Kids tablet + 6-Month Amazon Kids", "url": "https://dealsea.com/view-deal/1998371" }, { "comments_count": 0, "coupon_code": null, "deal_id": "1998281", "description": "Samsung Galaxy Book4 Edge 15.6\" FHD Laptop (Qualcomm Snapdragon X X1-26-100 8GB 256GB). ebay $449.99 Best Buy $449.99", "image_url": "https://i.dealsea.com/images/prod/26/11/1794205794.jpg", "price": 449.99, "price_text": "$449.99", "store": null, "title": "Samsung Galaxy Book4 Edge 15.6\" FHD Laptop (Qualcomm Snapdragon X X1-26-100 8GB 256GB)", "url": "https://dealsea.com/view-deal/1998281" }, { "comments_count": 1, "coupon_code": null, "deal_id": "1997495", "description": "Horizon Forbidden West Standard Edition - PlayStation 5. Amazon $29.99", "image_url": "https://i.dealsea.com/images/prod/26/10/1793030719659.jpg", "price": 29.99, "price_text": "$29.99", "store": null, "title": "Horizon Forbidden West Standard Edition - PlayStation 5", "url": "https://dealsea.com/view-deal/1997495" } ], "next_page": 2, "observed_at_ms": 1794341308895, "page": 1, "query": null, "source_url": "https://dealsea.com/deals/b?node=31", "title": "Electronics", "total_count": null } ``` ### List deals - Capability: `deals/list_deals` - Description: DealSea's front page, newest first: one page of up to 50 deals with headline price, store, quoted promo code, write-up and comment count. - Instructions: Start here for today's deals. Follow deal_id into get_deal for the posting time and store domain. - Cost: 5 credits per call - Capability file: [List deals](https://alexandria.firecrawl.dev/agents/providers/dealsea-com/deals/list_deals) Accepted options: - `page` (number): 1-based page number. Example: `1` Response schema example: ```json { "category": null, "count": 50, "deals": [ { "comments_count": 0, "coupon_code": null, "deal_id": "1998378", "description": "Amazon has Dyson V9 Motorbar Cordless Vacuum Cleaner for $269.99. Shipping is free. [Dyson]", "image_url": "https://i.dealsea.com/images/prod/26/11/1794338860.jpg", "price": 269.99, "price_text": "$269.99", "store": "Amazon", "title": "Dyson V9 Motorbar Cordless Vacuum Cleaner", "url": "https://dealsea.com/view-deal/1998378" }, { "comments_count": 0, "coupon_code": "SHOPBRANDS20", "deal_id": "1998376", "description": "adidas via eBay has Men's Adilette Lite Slides, in various colors for $12 - 20% off with promo code \"SHOPBRANDS20\" = $9.60. Shipping is free.", "image_url": "https://i.dealsea.com/images/prod/26/7/1785289475.jpg", "price": 9.6, "price_text": "$9.60", "store": "adidas via eBay", "title": "adidas Men's Adilette Lite Slides (3 colors)", "url": "https://dealsea.com/view-deal/1998376" }, { "comments_count": 0, "coupon_code": null, "deal_id": "1998375", "description": "Amazon has 12-Pack 12-Oz Celsius Sparkling Sugar Free Energy Drink (Spritz Vibe Summer) for $19.99 - $5 - 5% with subscribe = $14. Shipping is free with Prime or on $35+.", "image_url": "https://i.dealsea.com/images/prod/26/11/1794337746.jpg", "price": 14, "price_text": "$14", "store": "Amazon", "title": "12-Pack 12-Oz Celsius Sparkling Sugar Free Energy Drink", "url": "https://dealsea.com/view-deal/1998375" } ], "next_page": 2, "observed_at_ms": 1794341308362, "page": 1, "query": null, "source_url": "https://dealsea.com/", "title": null, "total_count": null } ``` ### Search deals - Capability: `deals/search_deals` - Description: Keyword search of DealSea deals, 10 per page with the site's total match count. A query with no matches returns an empty list. - Instructions: When the user names a product, brand or kind of item. - Cost: 5 credits per call - Capability file: [Search deals](https://alexandria.firecrawl.dev/agents/providers/dealsea-com/deals/search_deals) Accepted options: - `page` (number): 1-based page number. Example: `1` - `query` (string, required): Search words, as typed into the site's search box. Example: `` Response schema example: ```json { "category": null, "count": 10, "deals": [ { "comments_count": 0, "coupon_code": null, "deal_id": "1998281", "description": "Samsung Galaxy Book4 Edge 15.6\" FHD Laptop (Qualcomm Snapdragon X X1-26-100 8GB 256GB). ebay $449.99 Best Buy $449.99", "image_url": "https://i.dealsea.com/images/prod/26/11/1794205794.jpg", "price": 449.99, "price_text": "$449.99", "store": null, "title": "Samsung Galaxy Book4 Edge 15.6\" FHD Laptop (Qualcomm Snapdragon X X1-26-100 8GB 256GB)", "url": "https://dealsea.com/view-deal/1998281" }, { "comments_count": 12, "coupon_code": null, "deal_id": "1970109", "description": "Apple 2025 14.2\" MacBook Pro Laptop (M5 16GB 1TB). Shipping is free. Amazon: Space Black $1799, Silver $1797 BHPhotoVideo (96W Power Adapter) $1799 BHPhotoVideo (70W Power Adapter) $1799 Costco (oos) Best Buy $1999", "image_url": "https://i.dealsea.com/images/prod/25/10/1760807296.jpg", "price": 1797, "price_text": "$1797", "store": null, "title": "Apple 14.2\" MacBook Pro Laptop (M5 16GB 1TB)", "url": "https://dealsea.com/view-deal/1970109" }, { "comments_count": 0, "coupon_code": null, "deal_id": "1998369", "description": "Lenovo has Lenovo ThinkBook 14x 14” WUXGA Laptop (Ultra 5 226V 16GB 256GB) 22BG005QUS for $699. Shipping is free.", "image_url": "https://i.dealsea.com/images/prod/26/8/1787796825.jpg", "price": 699, "price_text": "$699", "store": "Lenovo", "title": "Lenovo ThinkBook 14x 14” WUXGA Laptop (Ultra 5 226V 16GB 256GB)", "url": "https://dealsea.com/view-deal/1998369" } ], "next_page": 2, "observed_at_ms": 1794341308803, "page": 1, "query": "laptop", "source_url": "https://dealsea.com/search?q=laptop&search_mode=Deals", "title": null, "total_count": 19736 } ```