---
type: "firecrawl-provider"
description: "hotukdeals (www.hotukdeals.com), the UK deals community on the Pepper platform: trending, new, hottest and category deal listings and keyword or merchant deal search with price, comparison price, voucher code, temperature (votes), comments, merchant and expiry; deal detail with full text and groups; and merchant voucher pages with every active code or offer, its discount, expiry, last use and verification."
use_when: "hotukdeals (www.hotukdeals.com), the UK deals community on the Pepper platform: trending, new, hottest and category deal listings and keyword or merchant deal search with price, comparison price, voucher code, temperature (votes), comments, merchant and expiry; deal detail with full text and groups; and merchant voucher pages with every active code or offer, its discount, expiry, last use and verification."
categories: "Retail"
capabilities: 4
credits_per_call: 5
---
# hotukdeals on Firecrawl Alexandria

hotukdeals (www.hotukdeals.com), the UK deals community on the Pepper platform: trending, new, hottest and category deal listings and keyword or merchant deal search with price, comparison price, voucher code, temperature (votes), comments, merchant and expiry; deal detail with full text and groups; and merchant voucher pages with every active code or offer, its discount, expiry, last use and verification.

- Categories: Retail
- Category index: [Retail category](https://alexandria.firecrawl.dev/agents/categories/retail)
- Provider key: `hotukdeals-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/hotukdeals-com)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/hotukdeals-com/openapi.json)

## Capabilities

- [Get deal](https://alexandria.firecrawl.dev/agents/providers/hotukdeals-com/deals/get_deal): One hotukdeals thread: title, type, price, comparison price, discount, delivery, voucher code, temperature, comments, merchant and its link host, posting, start and end times, expired flag, full description, group path and the click-out link.
- [List deals](https://alexandria.firecrawl.dev/agents/providers/hotukdeals-com/deals/list_deals): One page (30 threads) of a hotukdeals deal listing: trending (default), new, hottest, or one group such as electronics. Each deal has id, title, price, comparison price, discount, delivery cost, voucher code, temperature and level, comments, merchant, group, posting and end times and expired flag.
- [Merchant vouchers](https://alexandria.firecrawl.dev/agents/providers/hotukdeals-com/deals/merchant_vouchers): A hotukdeals merchant voucher page (/vouchers/<merchant>): every active offer with code (null for no-code deals), headline discount, title, terms, start and expiry, last time used, verified flag and date, exclusive and editor's pick flags, plus the count of expired offers.
- [Search deals](https://alexandria.firecrawl.dev/agents/providers/hotukdeals-com/deals/search_deals): hotukdeals deal search by keyword, by merchant id, or both: one page of 30 matching threads with the same fields as list_deals and the total match count. A query with no matches returns no deals.

## 1. Choose this provider when

hotukdeals (www.hotukdeals.com), the UK deals community on the Pepper platform: trending, new, hottest and category deal listings and keyword or merchant deal search with price, comparison price, voucher code, temperature (votes), comments, merchant and expiry; deal detail with full text and groups; and merchant voucher pages with every active code or offer, its discount, expiry, last use and verification.

## 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": "hotukdeals-com",
  "capability": "deals/get_deal",
  "options": {
    "deal_id": "5026861"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `deal_id` (string): Thread id, e.g. 5028218. Pattern: ^[1-9][0-9]*$. Example: `<deal_id>`
- `url` (string): A hotukdeals.com /deals/<title>-<id> or /share-deal/<id> URL. Example: `<url>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "hotukdeals-com",
    capability: "deals/get_deal",
    options: {
      deal_id: "5026861",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "hotukdeals-com",
  "capability": "deals/get_deal",
  "options": {
    "deal_id": "5026861"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "hotukdeals-com",
    "capability": "deals/get_deal",
    "options": {
      "deal_id": "5026861"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'hotukdeals-com/deals/get_deal' \
  --options '{"deal_id":"5026861"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "hotukdeals-com",
  "capability": "deals/get_deal",
  "options": {
    "deal_id": "5026861"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "hotukdeals-com",
  "capability": "deals/get_deal",
  "options": {
    "deal_id": "5026861"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "author": "MrSwitch",
  "comment_count": 6,
  "deal_id": "5026861",
  "description": "Joybuy matched price\nAbout this item\nREBUILT FOR COMFORT — AirPods 4 have been redesigned for exceptional all-day comfort and greater stability. With a refined contour, shorter stem, and quick-press controls for music or calls.\nPERSONALISED SPATIAL AUDIO — Personalised Spatial Audio with dynamic head tracking places sound all around you, creating a cinema-like listening experience for music, TV shows, movies, games and more.\nIMPROVED SOUND AND CALL QUALITY — AirPods 4 feature the Apple-designed H2 chip. Voice Isolation improves the quality of phone calls in loud conditions. Using advanced computational audio, it reduces background noise while isolating and clarifying the sound of your voice for whoever you’re speaking to.\nMAGICAL EXPERIENCE — Just say “Siri” or “Hey Siri” to play a song, make a call or check your schedule. And with Siri Interactions, now you can respond to Siri by simply nodding your head yes or shaking your head no. Pair AirPods 4 by simply placing them near your device and tapping Connect on your screen. Easily share a song or show between two sets of AirPods. An optical in-ear sensor knows to play audio only when you’re wearing AirPods and pauses when you take them off. And you can track down your AirPods and Charging Case with the Find My app.\nLONG BATTERY LIFE — Get up to 5 hours of listening time on a single charge. And get up to 30 hours of total listening time using the case.\nREDESIGNED CASE — The Charging Case comes with USB-C charging capabilities and is more than 10 per cent smaller by volume than the previous generation.\nDUST, SWEAT AND WATER RESISTANT — AirPods 4 and the Charging Case are rated IP54 dust, sweat and water resistant, so they’ll withstand rain and heavy workouts.\nLet Us Help You\nTrack Packages or View Orders\nDelivery Rates & Policies\nAmazon Prime\nReturns & Replacements\nTrustpilot",
  "discount_percent": null,
  "ends_at": "2026-11-09T13:14:17Z",
  "group": {
    "name": "Electronics",
    "slug": "electronics"
  },
  "groups": [
    {
      "name": "Apple AirPods",
      "slug": "apple-airpods"
    },
    {
      "name": "Headphones",
      "slug": "headphones"
    },
    {
      "name": "Audio & Hi-Fi",
      "slug": "audio"
    },
    {
      "name": "Electronics",
      "slug": "electronics"
    }
  ],
  "image_url": "https://images.hotukdeals.com/threads/raw/ZWEBr/5026861_1/re/300x300/qt/60/5026861_1.jpg",
  "is_expired": true,
  "is_hot": true,
  "is_local": false,
  "link_host": "www.amazon.co.uk",
  "merchant": {
    "id": "1650",
    "name": "Amazon",
    "slug": "amazon-uk"
  },
  "next_best_price": null,
  "observed_at_ms": 1794340000000,
  "posted_at": "2026-11-09T09:12:41Z",
  "price": 76.62,
  "share_url": "https://www.hotukdeals.com/share-deal/5026861",
  "shipping_free": true,
  "shipping_price": null,
  "starts_at": null,
  "status": "Activated",
  "temperature": 512.75,
  "temperature_level": "Hot3",
  "title": "Apple AirPods 4 Wireless Earbuds, Bluetooth Headphones At Checkout",
  "type": "deal",
  "updated_at": "2026-11-09T13:14:17Z",
  "url": "https://www.hotukdeals.com/deals/apple-airpods-4-wireless-earbuds-bluetooth-headphones-at-checkout-5026861",
  "visit_url": "https://www.hotukdeals.com/visit/threadmain/5026861",
  "voucher_code": null
}
```

## 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 hotukdeals thread: title, type, price, comparison price, discount, delivery, voucher code, temperature, comments, merchant and its link host, posting, start and end times, expired flag, full description, group path and the click-out link.
- Instructions: After list_deals or search_deals, or when the user pastes a hotukdeals deal URL, to read the description, check the code or whether it expired.
- Cost: 5 credits per call
- Capability file: [Get deal](https://alexandria.firecrawl.dev/agents/providers/hotukdeals-com/deals/get_deal)

Accepted options:
- `deal_id` (string): Thread id, e.g. 5028218. Pattern: ^[1-9][0-9]*$. Example: `<deal_id>`
- `url` (string): A hotukdeals.com /deals/<title>-<id> or /share-deal/<id> URL. Example: `<url>`

Response schema example:
```json
{
  "author": "MrSwitch",
  "comment_count": 6,
  "deal_id": "5026861",
  "description": "Joybuy matched price\nAbout this item\nREBUILT FOR COMFORT — AirPods 4 have been redesigned for exceptional all-day comfort and greater stability. With a refined contour, shorter stem, and quick-press controls for music or calls.\nPERSONALISED SPATIAL AUDIO — Personalised Spatial Audio with dynamic head tracking places sound all around you, creating a cinema-like listening experience for music, TV shows, movies, games and more.\nIMPROVED SOUND AND CALL QUALITY — AirPods 4 feature the Apple-designed H2 chip. Voice Isolation improves the quality of phone calls in loud conditions. Using advanced computational audio, it reduces background noise while isolating and clarifying the sound of your voice for whoever you’re speaking to.\nMAGICAL EXPERIENCE — Just say “Siri” or “Hey Siri” to play a song, make a call or check your schedule. And with Siri Interactions, now you can respond to Siri by simply nodding your head yes or shaking your head no. Pair AirPods 4 by simply placing them near your device and tapping Connect on your screen. Easily share a song or show between two sets of AirPods. An optical in-ear sensor knows to play audio only when you’re wearing AirPods and pauses when you take them off. And you can track down your AirPods and Charging Case with the Find My app.\nLONG BATTERY LIFE — Get up to 5 hours of listening time on a single charge. And get up to 30 hours of total listening time using the case.\nREDESIGNED CASE — The Charging Case comes with USB-C charging capabilities and is more than 10 per cent smaller by volume than the previous generation.\nDUST, SWEAT AND WATER RESISTANT — AirPods 4 and the Charging Case are rated IP54 dust, sweat and water resistant, so they’ll withstand rain and heavy workouts.\nLet Us Help You\nTrack Packages or View Orders\nDelivery Rates & Policies\nAmazon Prime\nReturns & Replacements\nTrustpilot",
  "discount_percent": null,
  "ends_at": "2026-11-09T13:14:17Z",
  "group": {
    "name": "Electronics",
    "slug": "electronics"
  },
  "groups": [
    {
      "name": "Apple AirPods",
      "slug": "apple-airpods"
    },
    {
      "name": "Headphones",
      "slug": "headphones"
    },
    {
      "name": "Audio & Hi-Fi",
      "slug": "audio"
    },
    {
      "name": "Electronics",
      "slug": "electronics"
    }
  ],
  "image_url": "https://images.hotukdeals.com/threads/raw/ZWEBr/5026861_1/re/300x300/qt/60/5026861_1.jpg",
  "is_expired": true,
  "is_hot": true,
  "is_local": false,
  "link_host": "www.amazon.co.uk",
  "merchant": {
    "id": "1650",
    "name": "Amazon",
    "slug": "amazon-uk"
  },
  "next_best_price": null,
  "observed_at_ms": 1794340000000,
  "posted_at": "2026-11-09T09:12:41Z",
  "price": 76.62,
  "share_url": "https://www.hotukdeals.com/share-deal/5026861",
  "shipping_free": true,
  "shipping_price": null,
  "starts_at": null,
  "status": "Activated",
  "temperature": 512.75,
  "temperature_level": "Hot3",
  "title": "Apple AirPods 4 Wireless Earbuds, Bluetooth Headphones At Checkout",
  "type": "deal",
  "updated_at": "2026-11-09T13:14:17Z",
  "url": "https://www.hotukdeals.com/deals/apple-airpods-4-wireless-earbuds-bluetooth-headphones-at-checkout-5026861",
  "visit_url": "https://www.hotukdeals.com/visit/threadmain/5026861",
  "voucher_code": null
}
```

### List deals

- Capability: `deals/list_deals`
- Description: One page (30 threads) of a hotukdeals deal listing: trending (default), new, hottest, or one group such as electronics. Each deal has id, title, price, comparison price, discount, delivery cost, voucher code, temperature and level, comments, merchant, group, posting and end times and expired flag.
- Instructions: Start here for current UK deals or deals in a category. Follow deal_id into get_deal, or merchant.id into search_deals.
- Cost: 5 credits per call
- Capability file: [List deals](https://alexandria.firecrawl.dev/agents/providers/hotukdeals-com/deals/list_deals)

Accepted options:
- `group` (string): Group slug from /tag/<slug>, e.g. electronics, gaming, groceries; not combined with sort. Pattern: ^[a-z0-9][a-z0-9.-]*$. Example: `<group>`
- `page` (number): 1-based page of 30 threads. Example: `1`
- `sort` (string): trending: rising now; new: newest; hottest: highest temperature recently. Example: `trending`

Response schema example:
```json
{
  "count": 3,
  "deals": [
    {
      "author": "flakjaketpotato",
      "comment_count": 2,
      "deal_id": "5028588",
      "discount_percent": null,
      "ends_at": "2026-11-10T23:59:00Z",
      "group": {
        "name": "Fashion & Accessories",
        "slug": "fashion"
      },
      "image_url": "https://images.hotukdeals.com/threads/raw/cz1d9/5028588_1/re/300x300/qt/60/5028588_1.jpg",
      "is_expired": false,
      "is_hot": true,
      "is_local": false,
      "link_host": "www.zalando.co.uk",
      "merchant": {
        "id": "35182",
        "name": "Zalando",
        "slug": "zalando.co.uk"
      },
      "next_best_price": null,
      "posted_at": "2026-11-10T17:35:32Z",
      "price": 62.4,
      "share_url": "https://www.hotukdeals.com/share-deal/5028588",
      "shipping_free": null,
      "shipping_price": 3.99,
      "starts_at": null,
      "temperature": 102.12,
      "temperature_level": "Hot2",
      "title": "Casio G-Shock GA-2100LXB-1A9 Luxe Black Series with Vapor Deposited Indices with code",
      "type": "deal",
      "updated_at": "2026-11-10T17:46:51Z",
      "url": "https://www.hotukdeals.com/deals/casio-g-shock-ga-2100lxb-1a9-luxe-black-series-with-vapor-deposited-indices-5028588",
      "voucher_code": "SINGLESDAY"
    },
    {
      "author": "Grumpy_Dumpty",
      "comment_count": 0,
      "deal_id": "5027389",
      "discount_percent": null,
      "ends_at": null,
      "group": {
        "name": "Family & Kids",
        "slug": "kids"
      },
      "image_url": "https://images.hotukdeals.com/threads/raw/Yrz7i/5027389_1/re/300x300/qt/60/5027389_1.jpg",
      "is_expired": false,
      "is_hot": true,
      "is_local": false,
      "link_host": "www.amazon.co.uk",
      "merchant": {
        "id": "1650",
        "name": "Amazon",
        "slug": "amazon-uk"
      },
      "next_best_price": null,
      "posted_at": "2026-11-09T19:32:25Z",
      "price": 5.51,
      "share_url": "https://www.hotukdeals.com/share-deal/5027389",
      "shipping_free": null,
      "shipping_price": null,
      "starts_at": null,
      "temperature": 100.7,
      "temperature_level": "Hot2",
      "title": "Mattel Disney Princess Dolls, Moana Posable Fashion Doll with Sparkling Clothing and Accessories - With voucher",
      "type": "deal",
      "updated_at": "2026-11-10T13:53:30Z",
      "url": "https://www.hotukdeals.com/deals/mattel-disney-princess-dolls-moana-posable-fashion-doll-with-sparkling-clothing-and-accessories-disney-movie-toys-hlw05-orange-outfi-5027389",
      "voucher_code": null
    },
    {
      "author": "hiccup999",
      "comment_count": 2,
      "deal_id": "5028159",
      "discount_percent": null,
      "ends_at": null,
      "group": {
        "name": "Fashion & Accessories",
        "slug": "fashion"
      },
      "image_url": "https://images.hotukdeals.com/threads/raw/adkBO/5028159_1/re/300x300/qt/60/5028159_1.jpg",
      "is_expired": false,
      "is_hot": true,
      "is_local": false,
      "link_host": "www.uniqlo.com",
      "merchant": {
        "id": "7021",
        "name": "Uniqlo",
        "slug": "www.uniqlo.com"
      },
      "next_best_price": null,
      "posted_at": "2026-11-10T11:35:54Z",
      "price": 9.9,
      "share_url": "https://www.hotukdeals.com/share-deal/5028159",
      "shipping_free": null,
      "shipping_price": 3.95,
      "starts_at": null,
      "temperature": 102.41,
      "temperature_level": "Hot2",
      "title": "Uniqlo New to Sale Pointelle Cardi /Tiered Maxi Skirt £12.90 /Stretch Leggings /Flannel or Ribbed Trousers £19.90 /Satin dress - Free C&C",
      "type": "deal",
      "updated_at": "2026-11-10T11:39:38Z",
      "url": "https://www.hotukdeals.com/deals/uniqlo-new-to-sale-pointelle-cardigan-tiered-maxi-skirt-ps1290-stretch-leggings-flannel-trousers-ps1990-ribbed-trousers-satin-dress-5028159",
      "voucher_code": null
    }
  ],
  "group": null,
  "last_page": 334,
  "listing": "trending",
  "merchant_id": null,
  "next_page": 2,
  "observed_at_ms": 1794340000000,
  "page": 1,
  "query": null,
  "total_count": 10000
}
```

### Merchant vouchers

- Capability: `deals/merchant_vouchers`
- Description: A hotukdeals merchant voucher page (/vouchers/<merchant>): every active offer with code (null for no-code deals), headline discount, title, terms, start and expiry, last time used, verified flag and date, exclusive and editor's pick flags, plus the count of expired offers.
- Instructions: For UK discount codes, promo codes or voucher codes at one store (amazon-uk, boots.com, currys.co.uk, deliveroo.co.uk).
- Cost: 5 credits per call
- Capability file: [Merchant vouchers](https://alexandria.firecrawl.dev/agents/providers/hotukdeals-com/deals/merchant_vouchers)

Accepted options:
- `merchant` (string): Voucher page slug as in /vouchers/<slug>: usually the store domain (boots.com, currys.co.uk), sometimes a name (amazon-uk, argos). Pattern: ^[A-Za-z0-9][A-Za-z0-9.-]*$. Example: `<merchant>`
- `url` (string): A hotukdeals.com/vouchers/<slug> URL. Example: `<url>`

Response schema example:
```json
{
  "active_count": 43,
  "code_count": 5,
  "count": 6,
  "expired_count": 3056,
  "merchant": {
    "name": "Boots",
    "slug": "boots.com",
    "url": "https://www.hotukdeals.com/vouchers/boots.com"
  },
  "observed_at_ms": 1794340000000,
  "offers": [
    {
      "code": "BABY50",
      "description": null,
      "discount": "15% OFF",
      "editors_pick": false,
      "evergreen": false,
      "exclusive": false,
      "expires_at": "2026-11-11T23:59:59.000Z",
      "last_used_at": "2026-11-10T19:22:56.670Z",
      "offer_id": "bc3366f4-8996-4716-9504-62d7aa6e0b2e",
      "starts_at": "2026-10-20T23:01:01.000Z",
      "terms": "Minimum spend of £50 applies with no maximum savings cap. Online only, valid on select baby items on the Boots promotional page.",
      "title": "Use this Boots discount code for 15% off on baby orders £50+",
      "type": "code",
      "verified": true,
      "verified_at": "2026-11-06T10:48:09.574Z"
    },
    {
      "code": "BABY30",
      "description": null,
      "discount": "10% OFF",
      "editors_pick": false,
      "evergreen": false,
      "exclusive": false,
      "expires_at": "2026-11-11T23:59:59.000Z",
      "last_used_at": "2026-11-10T18:17:41.928Z",
      "offer_id": "7ec38c12-c713-4187-bef6-6eb2414016db",
      "starts_at": "2026-11-04T03:05:12.000Z",
      "terms": "All customers can save with this 10% discount with no maximum cap as long as the minimum spend of £30 is met.",
      "title": "Take 10% off orders of baby items",
      "type": "code",
      "verified": true,
      "verified_at": "2026-11-06T10:47:50.183Z"
    },
    {
      "code": null,
      "description": null,
      "discount": "20% OFF",
      "editors_pick": false,
      "evergreen": false,
      "exclusive": false,
      "expires_at": "2026-11-16T23:59:59.000Z",
      "last_used_at": "2026-11-10T19:46:32.831Z",
      "offer_id": "1bf442e8-958a-4f22-88a4-e05e1997a5ab",
      "starts_at": "2026-11-05T00:01:14.000Z",
      "terms": "All customers can save 15% when you spend £25 or save 20% when you spend £45 on selected premium beauty. Online only offer, with no maximum savings cap stated.",
      "title": "Get 20% off when you spend £45, or 15% off orders of £25",
      "type": "deal",
      "verified": false,
      "verified_at": null
    },
    {
      "code": "DYSONFNDD",
      "description": null,
      "discount": "£100 OFF",
      "editors_pick": false,
      "evergreen": false,
      "exclusive": false,
      "expires_at": "2026-11-12T23:59:00.000Z",
      "last_used_at": "2026-11-10T18:07:18.846Z",
      "offer_id": "72fdaf17-dca3-4d47-9b01-5c34c4a6630e",
      "starts_at": "2026-10-16T12:20:09.000Z",
      "terms": "This code is online only, offering free next day delivery when customers buy select Dyson items. Select items shown on the promotional page, marked with the voucher. Customers can also get up to £100 off certain Dyson items, and collect £70 in points when they place their order on their Advantage card account. Offers can be stacked, but only one code can be used per order.",
      "title": "Enjoy up to £100 off Dyson plus free next day delivery",
      "type": "code",
      "verified": true,
      "verified_at": "2026-10-30T06:32:06.949Z"
    },
    {
      "code": "SAMSUNG100",
      "description": null,
      "discount": "£100 OFF",
      "editors_pick": false,
      "evergreen": false,
      "exclusive": false,
      "expires_at": "2026-11-11T23:59:59.000Z",
      "last_used_at": "2026-11-10T12:11:11.660Z",
      "offer_id": "f329d3a9-d4dc-435d-915c-54bcfb3d2e38",
      "starts_at": "2026-10-29T13:48:33.000Z",
      "terms": "This code is open to all customers to save £100 when they buy select Samsung Galaxy Watch 9s. This is an online only offer, which can be combined with other promotions. Note that only one offer code can be used per transaction.",
      "title": "Get £100 off select Samsung watches with this voucher",
      "type": "code",
      "verified": true,
      "verified_at": "2026-10-29T16:26:37.761Z"
    },
    {
      "code": "SAMSUNG50",
      "description": null,
      "discount": "£50 OFF",
      "editors_pick": false,
      "evergreen": false,
      "exclusive": false,
      "expires_at": "2026-11-11T23:59:59.000Z",
      "last_used_at": "2026-11-10T18:33:39.446Z",
      "offer_id": "06005b33-544b-4e34-8c3e-8afe1af538a7",
      "starts_at": "2026-10-29T14:54:36.000Z",
      "terms": "This code is open to all customers to save £50 when they buy select Samsung Galaxy Watch 9s. This is an online only offer, which can be combined with other promotions. Note that only one offer code can be used per transaction.",
      "title": "Save £50 on purchases of Samsung watches",
      "type": "code",
      "verified": true,
      "verified_at": "2026-10-29T16:23:48.763Z"
    }
  ]
}
```

### Search deals

- Capability: `deals/search_deals`
- Description: hotukdeals deal search by keyword, by merchant id, or both: one page of 30 matching threads with the same fields as list_deals and the total match count. A query with no matches returns no deals.
- Instructions: For deals on a product or brand (airpods, ps5) or every deal for one merchant (merchant.id from a listed deal, e.g. 1650 for Amazon).
- Cost: 5 credits per call
- Capability file: [Search deals](https://alexandria.firecrawl.dev/agents/providers/hotukdeals-com/deals/search_deals)

Accepted options:
- `merchant_id` (string): hotukdeals merchant id (merchant.id in results). Pattern: ^[1-9][0-9]*$. Example: `<merchant_id>`
- `page` (number): 1-based page of 30 threads. Example: `1`
- `query` (string): Search words. Example: `<query>`

Response schema example:
```json
{
  "count": 3,
  "deals": [
    {
      "author": "AndySco",
      "comment_count": 3,
      "deal_id": "5028218",
      "discount_percent": null,
      "ends_at": null,
      "group": {
        "name": "Electronics",
        "slug": "electronics"
      },
      "image_url": "https://images.hotukdeals.com/threads/raw/85Ttc/5028218_1/re/300x300/qt/60/5028218_1.jpg",
      "is_expired": false,
      "is_hot": false,
      "is_local": false,
      "link_host": "www.amazon.co.uk",
      "merchant": {
        "id": "1650",
        "name": "Amazon",
        "slug": "amazon-uk"
      },
      "next_best_price": null,
      "posted_at": "2026-11-10T12:14:25Z",
      "price": 4.1,
      "share_url": "https://www.hotukdeals.com/share-deal/5028218",
      "shipping_free": null,
      "shipping_price": null,
      "starts_at": null,
      "temperature": 48.44,
      "temperature_level": "Hot1",
      "title": "OtterBox Clear Headphone Case for AirPods Pro (Pro 2), Paris",
      "type": "deal",
      "updated_at": "2026-11-10T12:20:07Z",
      "url": "https://www.hotukdeals.com/deals/otterbox-clear-headphone-case-for-airpods-pro-pro-2-paris-5028218",
      "voucher_code": null
    },
    {
      "author": "Libre11",
      "comment_count": 9,
      "deal_id": "5026788",
      "discount_percent": null,
      "ends_at": "2026-12-03T23:59:00Z",
      "group": {
        "name": "Electronics",
        "slug": "electronics"
      },
      "image_url": "https://images.hotukdeals.com/threads/raw/Eo1YE/5026788_1/re/300x300/qt/60/5026788_1.jpg",
      "is_expired": false,
      "is_hot": true,
      "is_local": false,
      "link_host": "www.joybuy.co.uk",
      "merchant": {
        "id": "47444",
        "name": "Joybuy",
        "slug": "joybuy.com"
      },
      "next_best_price": 99,
      "posted_at": "2026-11-09T06:44:12Z",
      "price": 74,
      "share_url": "https://www.hotukdeals.com/share-deal/5026788",
      "shipping_free": null,
      "shipping_price": null,
      "starts_at": null,
      "temperature": 679.67,
      "temperature_level": "Hot3",
      "title": "Apple AirPods 4 via App + Possible 3 months of Spotify Premium for First Purchase - Lightning Offer w/ Coupon (Select Accounts)",
      "type": "deal",
      "updated_at": "2026-11-09T07:28:27Z",
      "url": "https://www.hotukdeals.com/deals/apple-airpods-4-via-app-w-coupon-possible-3-months-of-spotify-premium-for-first-purchase-lightning-offer-5026788",
      "voucher_code": null
    },
    {
      "author": "frshprince999",
      "comment_count": 0,
      "deal_id": "5026236",
      "discount_percent": null,
      "ends_at": null,
      "group": {
        "name": "Electronics",
        "slug": "electronics"
      },
      "image_url": "https://images.hotukdeals.com/threads/raw/fNpaB/5026236_1/re/300x300/qt/60/5026236_1.jpg",
      "is_expired": false,
      "is_hot": false,
      "is_local": false,
      "link_host": "www.musicmagpie.co.uk",
      "merchant": {
        "id": "13365",
        "name": "Music Magpie",
        "slug": "store.musicmagpie.co.uk"
      },
      "next_best_price": null,
      "posted_at": "2026-11-08T13:44:04Z",
      "price": 287.99,
      "share_url": "https://www.hotukdeals.com/share-deal/5026236",
      "shipping_free": null,
      "shipping_price": null,
      "starts_at": null,
      "temperature": 67.09,
      "temperature_level": "Hot1",
      "title": "Apple AirPods Max Green - Pristine Refurb - w/ Student or Graduate Beans Code",
      "type": "deal",
      "updated_at": "2026-11-08T13:45:18Z",
      "url": "https://www.hotukdeals.com/deals/apple-airpods-max-green-pristine-refurb-wcode-student-or-graduate-beans-5026236",
      "voucher_code": null
    }
  ],
  "group": null,
  "last_page": 13,
  "listing": "search",
  "merchant_id": null,
  "next_page": 2,
  "observed_at_ms": 1794340000000,
  "page": 1,
  "query": "airpods",
  "total_count": 386
}
```
