---
type: "firecrawl-provider"
description: "mydealz (www.mydealz.de), Germany's deals community on the Pepper platform: trending, new, hottest and group 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 Gutschein pages with every active code or offer, its discount, terms, expiry, last use and verification."
use_when: "mydealz (www.mydealz.de), Germany's deals community on the Pepper platform: trending, new, hottest and group 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 Gutschein pages with every active code or offer, its discount, terms, expiry, last use and verification."
categories: "Retail"
capabilities: 4
credits_per_call: 5
---
# mydealz on Firecrawl Alexandria

mydealz (www.mydealz.de), Germany's deals community on the Pepper platform: trending, new, hottest and group 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 Gutschein pages with every active code or offer, its discount, terms, expiry, last use and verification.

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

## More

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

## Capabilities

- [Get deal](https://alexandria.firecrawl.dev/agents/providers/mydealz-de/deals/get_deal): One mydealz 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/mydealz-de/deals/list_deals): One page (30 threads) of a mydealz deal listing: trending (default), new (/alles), hottest (/heisseste), or one group such as elektronik. Each deal has id, title, price in EUR, 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/mydealz-de/deals/merchant_vouchers): A mydealz merchant Gutschein page (/gutscheine/<merchant>): every active offer with code (null for no-code deals and for activation-style offers, whose instruction such as "siehe Details" goes to code_note), 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/mydealz-de/deals/search_deals): mydealz 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

mydealz (www.mydealz.de), Germany's deals community on the Pepper platform: trending, new, hottest and group 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 Gutschein pages with every active code or offer, its discount, terms, 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": "mydealz-de",
  "capability": "deals/get_deal",
  "options": {
    "deal_id": "2868178"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `deal_id` (string): Thread id, e.g. 2866857. Pattern: ^[1-9][0-9]*$. Example: `<deal_id>`
- `url` (string): A mydealz.de /deals/<title>-<id> (or /gutscheine/, /diskussion/) thread URL. Example: `<url>`

## 4. Request through your preferred interface

### JavaScript

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

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "mydealz-de",
  "capability": "deals/get_deal",
  "options": {
    "deal_id": "2868178"
  }
})
```

### cURL

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

### CLI

```sh
firecrawl scrape 'mydealz-de/deals/get_deal' \
  --options '{"deal_id":"2868178"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "mydealz-de",
  "capability": "deals/get_deal",
  "options": {
    "deal_id": "2868178"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "mydealz-de",
  "capability": "deals/get_deal",
  "options": {
    "deal_id": "2868178"
  }
}
```

## 6. Response data

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

```json
{
  "author": "Search85",
  "comment_count": 18,
  "deal_id": "2868178",
  "description": "Moinsen, bei Voelkner bekommt ihr die Apple AirPods 5 mit kabellosem Ladecase für 144,13€ inkl. Versand. Nutzt den Gutscheincode SINGLESDAY26 bei eurer Bestellung, damit der Gutschein funktioniert müsst ihr euch beim Newsletter anmelden, außerdem bekommt ihr dadurch 2 Jahre extra Garantie.\nPreisvergleich 155€\nDie AirPods 5 mit kabellosem Ladecase kommen mit bis zu 1,5x besserer Aktiver Geräusch­unterdrückung als bei der vorherigen Generation. Die überarbeitete akustische Architektur und der Adaptive EQ der nächsten Generation sorgen für einen satteren und detail­reicheren Klang.\nDas Open-Ear Design ermöglicht einen angenehmen Sitz über den ganzen Tag. Live Übersetzung hilft dir, in verschiedenen Sprachen zu kommunizieren. Fußnote 12 Ein Drucksensor mit Streichen zur Lautstärke­regelung lässt dich die Lautstärke ganz einfach anpassen.\nDas kabellose Ladecase ermöglicht bis zu 22 Stunden Wiedergabe mit Aktiver Geräusch­unter­drückung. Fußnote 25 Mit „Wo ist?“ verlierst du deine AirPods 5 nie aus dem Blick. Und das kabellose Ladecase hat einen integrierten Lautsprecher, der einen Ton abspielt, damit du es leichter findest. Und du kannst das Case mit einem Apple Watch Ladegerät oder Qi Ladegerät laden.\nDie AirPods 5 mit kabellosem Ladecase kommen außerdem mit Live Übersetzung, damit du dich dich in verschiedenen Sprachen unterhalten kannst – ermöglicht durch Apple Intelligence.",
  "discount_percent": null,
  "ends_at": "2026-11-10T15:59:05Z",
  "group": {
    "name": "Elektronik",
    "slug": "elektronik"
  },
  "groups": [
    {
      "name": "Apple AirPods",
      "slug": "airpods"
    },
    {
      "name": "Kopfhörer",
      "slug": "kopfhoerer"
    },
    {
      "name": "Audio & HiFi",
      "slug": "audio-hifi"
    },
    {
      "name": "Elektronik",
      "slug": "elektronik"
    }
  ],
  "image_url": "https://static.mydealz.de/threads/raw/ogCjN/2868178_1/re/300x300/qt/60/2868178_1.jpg",
  "is_expired": true,
  "is_hot": true,
  "is_local": false,
  "link_host": "www.voelkner.de",
  "merchant": {
    "id": "19",
    "name": "voelkner",
    "slug": "voelkner-de"
  },
  "next_best_price": 155,
  "observed_at_ms": 1794340000000,
  "posted_at": "2026-11-10T13:02:05Z",
  "price": 144.13,
  "share_url": "https://www.mydealz.de/share-deal/2868178",
  "shipping_free": true,
  "shipping_price": null,
  "starts_at": null,
  "status": "Activated",
  "temperature": 245.84,
  "temperature_level": "Hot3",
  "title": "Apple AirPods 5 mit kabellosem Ladecase für 144,13€ (Voelkner)",
  "type": "deal",
  "updated_at": "2026-11-10T15:59:05Z",
  "url": "https://www.mydealz.de/deals/apple-airpods-5-mit-kabellosem-ladecase-fur-14413eur-voelkner-2868178",
  "visit_url": "https://www.mydealz.de/visit/threadmain/2868178",
  "voucher_code": "SINGLESDAY26"
}
```

## 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 mydealz 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 mydealz 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/mydealz-de/deals/get_deal)

Accepted options:
- `deal_id` (string): Thread id, e.g. 2866857. Pattern: ^[1-9][0-9]*$. Example: `<deal_id>`
- `url` (string): A mydealz.de /deals/<title>-<id> (or /gutscheine/, /diskussion/) thread URL. Example: `<url>`

Response schema example:
```json
{
  "author": "Search85",
  "comment_count": 18,
  "deal_id": "2868178",
  "description": "Moinsen, bei Voelkner bekommt ihr die Apple AirPods 5 mit kabellosem Ladecase für 144,13€ inkl. Versand. Nutzt den Gutscheincode SINGLESDAY26 bei eurer Bestellung, damit der Gutschein funktioniert müsst ihr euch beim Newsletter anmelden, außerdem bekommt ihr dadurch 2 Jahre extra Garantie.\nPreisvergleich 155€\nDie AirPods 5 mit kabellosem Ladecase kommen mit bis zu 1,5x besserer Aktiver Geräusch­unterdrückung als bei der vorherigen Generation. Die überarbeitete akustische Architektur und der Adaptive EQ der nächsten Generation sorgen für einen satteren und detail­reicheren Klang.\nDas Open-Ear Design ermöglicht einen angenehmen Sitz über den ganzen Tag. Live Übersetzung hilft dir, in verschiedenen Sprachen zu kommunizieren. Fußnote 12 Ein Drucksensor mit Streichen zur Lautstärke­regelung lässt dich die Lautstärke ganz einfach anpassen.\nDas kabellose Ladecase ermöglicht bis zu 22 Stunden Wiedergabe mit Aktiver Geräusch­unter­drückung. Fußnote 25 Mit „Wo ist?“ verlierst du deine AirPods 5 nie aus dem Blick. Und das kabellose Ladecase hat einen integrierten Lautsprecher, der einen Ton abspielt, damit du es leichter findest. Und du kannst das Case mit einem Apple Watch Ladegerät oder Qi Ladegerät laden.\nDie AirPods 5 mit kabellosem Ladecase kommen außerdem mit Live Übersetzung, damit du dich dich in verschiedenen Sprachen unterhalten kannst – ermöglicht durch Apple Intelligence.",
  "discount_percent": null,
  "ends_at": "2026-11-10T15:59:05Z",
  "group": {
    "name": "Elektronik",
    "slug": "elektronik"
  },
  "groups": [
    {
      "name": "Apple AirPods",
      "slug": "airpods"
    },
    {
      "name": "Kopfhörer",
      "slug": "kopfhoerer"
    },
    {
      "name": "Audio & HiFi",
      "slug": "audio-hifi"
    },
    {
      "name": "Elektronik",
      "slug": "elektronik"
    }
  ],
  "image_url": "https://static.mydealz.de/threads/raw/ogCjN/2868178_1/re/300x300/qt/60/2868178_1.jpg",
  "is_expired": true,
  "is_hot": true,
  "is_local": false,
  "link_host": "www.voelkner.de",
  "merchant": {
    "id": "19",
    "name": "voelkner",
    "slug": "voelkner-de"
  },
  "next_best_price": 155,
  "observed_at_ms": 1794340000000,
  "posted_at": "2026-11-10T13:02:05Z",
  "price": 144.13,
  "share_url": "https://www.mydealz.de/share-deal/2868178",
  "shipping_free": true,
  "shipping_price": null,
  "starts_at": null,
  "status": "Activated",
  "temperature": 245.84,
  "temperature_level": "Hot3",
  "title": "Apple AirPods 5 mit kabellosem Ladecase für 144,13€ (Voelkner)",
  "type": "deal",
  "updated_at": "2026-11-10T15:59:05Z",
  "url": "https://www.mydealz.de/deals/apple-airpods-5-mit-kabellosem-ladecase-fur-14413eur-voelkner-2868178",
  "visit_url": "https://www.mydealz.de/visit/threadmain/2868178",
  "voucher_code": "SINGLESDAY26"
}
```

### List deals

- Capability: `deals/list_deals`
- Description: One page (30 threads) of a mydealz deal listing: trending (default), new (/alles), hottest (/heisseste), or one group such as elektronik. Each deal has id, title, price in EUR, 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 German 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/mydealz-de/deals/list_deals)

Accepted options:
- `group` (string): Group slug from /gruppe/<slug>, e.g. elektronik, gaming, lebensmittel; 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 (/trending); new: newest (/alles); hottest: highest temperature recently (/heisseste). Example: `trending`

Response schema example:
```json
{
  "count": 3,
  "deals": [
    {
      "author": "MRE99",
      "comment_count": 9,
      "deal_id": "2868462",
      "discount_percent": null,
      "ends_at": null,
      "group": {
        "name": "Family & Kids",
        "slug": "family-kids"
      },
      "image_url": "https://static.mydealz.de/threads/raw/lZy7d/2868462_1/re/300x300/qt/60/2868462_1.jpg",
      "is_expired": false,
      "is_hot": true,
      "is_local": false,
      "link_host": "www.amazon.de",
      "merchant": {
        "id": "3",
        "name": "Amazon",
        "slug": "amazon-de"
      },
      "next_best_price": 199.99,
      "posted_at": "2026-11-10T19:13:13Z",
      "price": 179.64,
      "share_url": "https://www.mydealz.de/share-deal/2868462",
      "shipping_free": null,
      "shipping_price": null,
      "starts_at": null,
      "temperature": 117.21,
      "temperature_level": "Hot2",
      "title": "Pokémon-Sammelkartenspiel: Display-Box Karmesin & Purpur (36 Boosterpacks) - Amazon Einladung",
      "type": "deal",
      "updated_at": "2026-11-10T19:14:40Z",
      "url": "https://www.mydealz.de/deals/pokemon-sammelkartenspiel-display-box-karmesin-purpur-36-boosterpacks-amazon-einladung-2868462",
      "voucher_code": null
    },
    {
      "author": "Eo.Eo.Eo",
      "comment_count": 2,
      "deal_id": "2868331",
      "discount_percent": null,
      "ends_at": "2026-12-31T22:59:00Z",
      "group": {
        "name": "Lebensmittel & Haushalt",
        "slug": "food"
      },
      "image_url": "https://static.mydealz.de/threads/raw/Mf1lb/2868331_1/re/300x300/qt/60/2868331_1.jpg",
      "is_expired": false,
      "is_hot": true,
      "is_local": true,
      "link_host": "www.einbecker-blackweeks.de",
      "merchant": null,
      "next_best_price": null,
      "posted_at": "2026-11-10T16:34:55Z",
      "price": 0,
      "share_url": "https://www.mydealz.de/share-deal/2868331",
      "shipping_free": null,
      "shipping_price": null,
      "starts_at": null,
      "temperature": 117.23,
      "temperature_level": "Hot2",
      "title": "Niedersachsen & Norddeutschland: 2€ Cashback auf einen Kasten Einbecker Bier",
      "type": "deal",
      "updated_at": "2026-11-10T16:34:54Z",
      "url": "https://www.mydealz.de/deals/niedersachsen-norddeutschland-2eur-cashback-auf-einen-kasten-einbecker-bier-2868331",
      "voucher_code": null
    },
    {
      "author": "M4NDY",
      "comment_count": 7,
      "deal_id": "2868467",
      "discount_percent": null,
      "ends_at": "2026-11-30T22:59:00Z",
      "group": {
        "name": "Lebensmittel & Haushalt",
        "slug": "food"
      },
      "image_url": "https://static.mydealz.de/threads/raw/DBMSF/2868467_1/re/300x300/qt/60/2868467_1.jpg",
      "is_expired": false,
      "is_hot": true,
      "is_local": false,
      "link_host": "www.amazon.de",
      "merchant": {
        "id": "3",
        "name": "Amazon",
        "slug": "amazon-de"
      },
      "next_best_price": 48.5,
      "posted_at": "2026-11-10T19:18:21Z",
      "price": 24.95,
      "share_url": "https://www.mydealz.de/share-deal/2868467",
      "shipping_free": null,
      "shipping_price": null,
      "starts_at": null,
      "temperature": 129.09,
      "temperature_level": "Hot2",
      "title": "GREY GOOSE Premium-Vodka aus Frankreich, 40 Vol.-%, 70 cl - Prime",
      "type": "deal",
      "updated_at": "2026-11-10T19:19:24Z",
      "url": "https://www.mydealz.de/deals/grey-goose-premium-vodka-aus-frankreich-40-vol-70-cl-2868467",
      "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 mydealz merchant Gutschein page (/gutscheine/<merchant>): every active offer with code (null for no-code deals and for activation-style offers, whose instruction such as "siehe Details" goes to code_note), 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 German Gutscheincodes, Rabattcodes or promo codes at one store (amazon-de, otto-de, zalando-de, wolt.com).
- Cost: 5 credits per call
- Capability file: [Merchant vouchers](https://alexandria.firecrawl.dev/agents/providers/mydealz-de/deals/merchant_vouchers)

Accepted options:
- `merchant` (string): Gutschein page slug as in /gutscheine/<slug>: usually the store domain with a hyphen (otto-de, zalando-de), sometimes the domain itself (wolt.com, temu.com). Pattern: ^[A-Za-z0-9][A-Za-z0-9.-]*$. Example: `<merchant>`
- `url` (string): A mydealz.de/gutscheine/<slug> URL. Example: `<url>`

Response schema example:
```json
{
  "active_count": 17,
  "code_count": 1,
  "count": 6,
  "expired_count": 1178,
  "merchant": {
    "name": "OTTO",
    "slug": "otto-de",
    "url": "https://www.mydealz.de/gutscheine/otto-de"
  },
  "observed_at_ms": 1794340000000,
  "offers": [
    {
      "code": null,
      "code_note": "Coupon auf der Seite aktivieren",
      "description": null,
      "discount": "20% Reduziert",
      "editors_pick": false,
      "evergreen": false,
      "exclusive": false,
      "expires_at": "2026-11-11T22:59:59.000Z",
      "last_used_at": "2026-11-10T19:59:40.975Z",
      "offer_id": "64ef454e-dac3-4775-bd9c-f6d3ccc262df",
      "starts_at": "2026-11-09T07:43:34.000Z",
      "terms": "Gilt nur in der OTTO App. Gilt für viele Artikel aus den Bereichen Mode, Beauty und Wohnen. Der Rabatt gilt auch für bereits reduzierte Artikel. Nach der Aktivierung wird dir die Ersparnis direkt auf der Artikeldetailseite, dem Merkzettel und im Warenkorb angezeigt. Nicht kombinierbar.",
      "title": "Zum Singles Day 20% OTTO Rabatt auf Mode, Wohnen und Beauty",
      "type": "code",
      "verified": false,
      "verified_at": null
    },
    {
      "code": null,
      "code_note": "Coupon auf der Seite aktivieren",
      "description": null,
      "discount": "11% Nachlass",
      "editors_pick": false,
      "evergreen": false,
      "exclusive": false,
      "expires_at": "2026-11-11T22:59:59.000Z",
      "last_used_at": "2026-11-10T19:59:19.575Z",
      "offer_id": "b61c62da-56e3-4db8-9d2c-c38753e0dae2",
      "starts_at": "2026-11-09T08:25:46.000Z",
      "terms": "Gilt für ausgesuchte Produkte, für alle Kunden einlösbar. Nicht kombinierbar.",
      "title": "11% Coupon auf ausgewählte Smart Home Artikel sichern",
      "type": "code",
      "verified": true,
      "verified_at": "2026-11-09T08:29:06.542Z"
    },
    {
      "code": null,
      "code_note": "Coupon auf der Seite aktivieren",
      "description": null,
      "discount": "11% Rabatt",
      "editors_pick": false,
      "evergreen": false,
      "exclusive": false,
      "expires_at": "2026-11-11T22:59:59.000Z",
      "last_used_at": "2026-11-10T19:54:51.318Z",
      "offer_id": "a04be532-0e2e-4a16-bc8f-5ed11df110b4",
      "starts_at": "2026-11-09T07:41:10.000Z",
      "terms": "Der Rabatt gilt ausschließlich nach Aktivierung in der OTTO-App und nur für gekennzeichnete Artikel aus den Bereichen Multimedia und Spielzeug von teilnehmenden Verkäufern. Gilt auch auf bereits reduzierte Produkte. Pro Artikel ist nur ein zusätzlicher Rabatt einlösbar. Wenn für einen Artikel mehrere Rabatte aktiviert sind, wird jeweils nur der höchste Rabattwert angewendet. Der Extra-Rabatt gilt nicht bei weiteren Rabattierungen auf den bereits reduzierten Preis. Ausgeschlossen sind außerdem der Kauf von OTTO-Geschenkgutscheinen, die Kombination mit anderen Aktionen, sonstige Lieferaufschläge sowie Aufbau- und Serviceleistungen. Eine Barauszahlung ist nicht möglich.",
      "title": "11% OTTO Gutschein auf Multimedia und Spielzeug einlösen",
      "type": "code",
      "verified": false,
      "verified_at": null
    },
    {
      "code": null,
      "code_note": "Coupon auf der Seite aktivieren",
      "description": null,
      "discount": "10% Rabatt",
      "editors_pick": false,
      "evergreen": false,
      "exclusive": false,
      "expires_at": "2026-11-15T22:59:59.000Z",
      "last_used_at": "2026-11-10T18:08:47.617Z",
      "offer_id": "ad73520d-e47f-4cde-99e0-fd55e83e8885",
      "starts_at": "2026-11-06T10:24:56.000Z",
      "terms": "Pro Artikel gilt nur ein Rabatt. Wenn mehrere Rabatte möglich sind, wird automatisch der höchste angewendet. Versandkosten und Zusatzleistungen sind jeweils ausgeschlossen. Barauszahlung ist ebenso ausgeschlossen.",
      "title": "10% OTTO Gutscheincode auf TVs und Soundbars von Hisense",
      "type": "code",
      "verified": true,
      "verified_at": "2026-11-06T10:28:04.909Z"
    },
    {
      "code": null,
      "code_note": "siehe Details",
      "description": null,
      "discount": "10€ Ersparnis",
      "editors_pick": false,
      "evergreen": false,
      "exclusive": false,
      "expires_at": "2026-12-09T22:59:59.000Z",
      "last_used_at": "2026-11-10T19:49:55.399Z",
      "offer_id": "869a4098-620f-419e-ac3a-2a991fc33640",
      "starts_at": "2026-11-05T09:54:40.000Z",
      "terms": "* Voraussetzung für den Gutscheinversand ist Deine Einwilligung zum Newsletter durch Klick auf den Bestätigungslink in der erhaltenen E-Mail * Der Versand des Gutscheins erfolgt wenige Tage nach Deiner Erstbestellung * Der Gutschein ist einmalig gültig und setzt einen Mindestbestellwert von 29€ voraus * Er gilt nur für Artikel des Verkäufers OTTO und nicht für den Kauf von OTTO-Geschenkgutscheinen, sonstige Lieferaufschläge, Aufbau- und Serviceleistungen sowie nicht für Mitarbeiter der Otto Group * Eine Übertragung oder Barauszahlung ist ausgeschlossen * Pro Bestellung kann nur ein Aktionsgutschein eingelöst werden. Sind mehrere aktivierte Gutscheine vorhanden, wird unabhängig vom Verfallsdatum automatisch der Gutschein mit der größten Ersparnis eingelöst.",
      "title": "10€ OTTO Rabattcode im Newsletter erhalten",
      "type": "code",
      "verified": false,
      "verified_at": null
    },
    {
      "code": "mydealz2026",
      "code_note": null,
      "description": null,
      "discount": "7% Rabatt",
      "editors_pick": false,
      "evergreen": false,
      "exclusive": false,
      "expires_at": "2026-12-31T22:59:59.000Z",
      "last_used_at": "2026-11-10T19:46:56.063Z",
      "offer_id": "f0813e02-9146-4aaf-a7c4-8289d71a523c",
      "starts_at": "2026-08-03T07:02:47.000Z",
      "terms": "Code aufzeichnen: Kopiere den angezeigten Code. Anmeldung durchführen: Logge Dich in die Vorteilswelt ein. Gutschein auswählen: Finde den Gutschein, der am besten zu Deinen Bedürfnissen passt. Gutschein erwerben: Kaufe ihn direkt über unseren Partner Cadooz. Beachte, dass Du Geschenkgutscheine zusammen mit regulären Gutscheinen und/oder Cashback kombinieren kannst, um noch mehr zu sparen.",
      "title": "7% Rabatt auf die Geschenkkarte von OTTO mit der Vorteilswelt",
      "type": "code",
      "verified": true,
      "verified_at": "2026-11-06T14:46:59.815Z"
    }
  ]
}
```

### Search deals

- Capability: `deals/search_deals`
- Description: mydealz 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. 3 for Amazon).
- Cost: 5 credits per call
- Capability file: [Search deals](https://alexandria.firecrawl.dev/agents/providers/mydealz-de/deals/search_deals)

Accepted options:
- `merchant_id` (string): mydealz 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": "Tedesco",
      "comment_count": 38,
      "deal_id": "2867694",
      "discount_percent": null,
      "ends_at": "2026-11-15T22:59:00Z",
      "group": {
        "name": "Telefon- & Internet-Verträge",
        "slug": "telefon-internet"
      },
      "image_url": "https://static.mydealz.de/threads/raw/8i0RY/2867694_1/re/300x300/qt/60/2867694_1.jpg",
      "is_expired": false,
      "is_hot": true,
      "is_local": false,
      "link_host": "www.shoop.de",
      "merchant": {
        "id": "509",
        "name": "Vodafone",
        "slug": "vodafone-de"
      },
      "next_best_price": null,
      "posted_at": "2026-11-09T23:25:50Z",
      "price": 0,
      "share_url": "https://www.mydealz.de/share-deal/2867694",
      "shipping_free": null,
      "shipping_price": null,
      "starts_at": null,
      "temperature": 602.54,
      "temperature_level": "Hot3",
      "title": "Shoop - Vodafone Black Week: 200€ Cashback für Tarife M/L/XL & gratis Apple Airpods 5 zu jedem iPhone",
      "type": "deal",
      "updated_at": "2026-11-10T07:08:31Z",
      "url": "https://www.mydealz.de/deals/shoop-vodafone-black-weeks-200eur-cashback-gratis-apple-airpods-5-zu-jedem-iphone-2867694",
      "voucher_code": null
    },
    {
      "author": "nelzus",
      "comment_count": 20,
      "deal_id": "2866857",
      "discount_percent": null,
      "ends_at": null,
      "group": {
        "name": "Elektronik",
        "slug": "elektronik"
      },
      "image_url": "https://static.mydealz.de/threads/raw/p6LN4/2866857_1/re/300x300/qt/60/2866857_1.jpg",
      "is_expired": false,
      "is_hot": true,
      "is_local": false,
      "link_host": "www.amazon.de",
      "merchant": {
        "id": "3",
        "name": "Amazon",
        "slug": "amazon-de"
      },
      "next_best_price": 14.99,
      "posted_at": "2026-11-08T11:35:43Z",
      "price": 8.99,
      "share_url": "https://www.mydealz.de/share-deal/2866857",
      "shipping_free": null,
      "shipping_price": null,
      "starts_at": null,
      "temperature": 205.54,
      "temperature_level": "Hot3",
      "title": "[Prime] Aioneus 40W USB-C Ladegerät | 4 Ports (2x USB-C PD 20W, 2x USB-A) für z. B. iPhone, Samsung Galaxy, iPad, AirPods",
      "type": "deal",
      "updated_at": "2026-11-09T12:49:24Z",
      "url": "https://www.mydealz.de/deals/prime-aioneus-40w-usb-c-ladegerat-4-ports-2x-usb-c-pd-20w-2x-usb-a-fur-z-b-iphone-samsung-galaxy-ipad-airpods-2866857",
      "voucher_code": null
    },
    {
      "author": "Search85",
      "comment_count": 9,
      "deal_id": "2865758",
      "discount_percent": null,
      "ends_at": null,
      "group": {
        "name": "Elektronik",
        "slug": "elektronik"
      },
      "image_url": "https://static.mydealz.de/threads/raw/Wsvyv/2865758_1/re/300x300/qt/60/2865758_1.webp",
      "is_expired": false,
      "is_hot": true,
      "is_local": false,
      "link_host": "www.joybuy.de",
      "merchant": {
        "id": "13322",
        "name": "Joybuy",
        "slug": "ochama.com"
      },
      "next_best_price": 134.19,
      "posted_at": "2026-11-06T09:01:38Z",
      "price": 129.19,
      "share_url": "https://www.mydealz.de/share-deal/2865758",
      "shipping_free": null,
      "shipping_price": null,
      "starts_at": null,
      "temperature": 388.95,
      "temperature_level": "Hot3",
      "title": "Apple AirPods 5 mit USB-C Ladecase für 129,19€ (Joybuy, Galaxus)",
      "type": "deal",
      "updated_at": "2026-11-07T22:47:11Z",
      "url": "https://www.mydealz.de/deals/apple-airpods-5-mit-usb-c-ladecase-fur-12919eur-joybuy-galaxus-2865758",
      "voucher_code": "EM9DA"
    }
  ],
  "group": null,
  "last_page": 10,
  "listing": "search",
  "merchant_id": null,
  "next_page": 2,
  "observed_at_ms": 1794340000000,
  "page": 1,
  "query": "airpods",
  "total_count": 289
}
```
