# Dealabs.com Scraper - French Deals & Coupons (`studio-amba/dealabs-scraper`) Actor

Extract live deals, discount codes and prices from dealabs.com, France's largest deals community (Pepper Group network). Get titles, prices, discount %, merchant, comment/heat score, coupon codes and expiry by category. No login required.

- **URL**: https://apify.com/studio-amba/dealabs-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Dealabs.com Scraper

Extract live deals and coupon codes from dealabs.com, France's largest deals community (part of the Pepper Group network, alongside mydealz.de, pepper.pl and hotukdeals.com).

### Why use this actor?

dealabs.com has no public API and its own keyword-search backend is off-limits to crawlers (disallowed in robots.txt). This actor reads the site the way a real category browser does — pulling the same structured deal data dealabs.com's own frontend uses to render each card — so you get clean, structured deals, discount codes, prices and community heat scores without scraping raw HTML by CSS selector. Useful for price-monitoring tools, deal-alert bots, market research on French ecommerce discounting, or feeding a broader European deals aggregator.

### How to scrape Dealabs data

1. Pick a category or product-keyword slug from the dealabs.com URL bar — visit `dealabs.com/groupe/{slug}` in a browser and copy the slug (e.g. `high-tech`, `maison-habitat`, `auto-moto`, `sports-plein-air`, or `gratuit` for free deals).
2. Set `category` to that slug, or leave it empty to pull the site-wide homepage deals feed instead.
3. Set `maxResults` (results load 30 at a time).
4. Run the actor. Each dealabs.com deal thread becomes one row in the output dataset: title, price, original price, discount %, merchant, shop domain, image, heat score, comment count, category, voucher code, and expiry when the poster set one.
5. Export the dataset as JSON, CSV, or connect it via API to your own pipeline.

There is no login, no cookie banner to dismiss, and no CAPTCHA in the way — dealabs.com's category pages are plain server-rendered HTML, and its Cloudflare protection is passive (no JS challenge encountered).

### A note on dealabs.com's own data

dealabs.com is a community-posted deals board, not a retailer's own product feed. Two things follow directly from that and aren't scraper bugs:

- **`price` is what the poster typed in**, and on a meaningful share of threads it doesn't exactly match the price mentioned in the title text itself. Always treat the title as the human-readable source of truth and `price`/`originalPrice` as the structured (but occasionally imprecise) numeric fields.
- **`price` is legitimately empty on a lot of deals.** Freebies, coupon-code-only posts, and press-release-style deals (`merchantName` also null on these) often carry no numeric price or registered merchant at all — that's the real shape of the data, not a missing DOM fallback.

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | String | No | dealabs.com category/keyword slug from `/groupe/{slug}` (e.g. `high-tech`, `maison-habitat`, `auto-moto`, `gratuit`). Empty = site-wide homepage deals feed. |
| `maxResults` | Integer | No | Maximum deals to return (default: 50, loads in pages of 30). |
| `proxyConfiguration` | Object | No | Proxy settings. Defaults to residential, France — dealabs.com's Cloudflare passes plain HTTP requests but intermittently blocks Apify's automatic/datacenter proxy IPs. |

### Output

Each result contains:

| Field | Type | Example |
|-------|------|---------|
| `dealId` | String | `"3388281"` |
| `title` | String | `"[Clients Sosh] Smartphone 6,3\" Google Pixel 10a 5G+..."` |
| `url` | String | Full dealabs.com deal page URL |
| `price` | Number | null | `229` |
| `originalPrice` | Number | null | `199` |
| `discountPercentage` | Number | null | `30` |
| `currency` | String | `"EUR"` |
| `merchantName` | String | null | `"Sosh"` |
| `shopDomain` | String | null | `"shop.sosh.fr"` |
| `imageUrl` | String | null | Deal image on dealabs.com's static CDN |
| `temperature` | Number | null | `5020.14` (community heat score) |
| `temperatureLevel` | String | null | `"Hot2"` |
| `commentCount` | Number | null | `554` |
| `category` | String | null | `"High-Tech"` |
| `categorySlug` | String | null | `"high-tech"` |
| `voucherCode` | String | null | `"AUGSAVE"` |
| `isExpired` | Boolean | `false` |
| `isHot` | Boolean | `true` |
| `isNew` | Boolean | `false` |
| `freeShipping` | Boolean | null | `null` |
| `publishedAt` | String | null | ISO 8601 timestamp |
| `expiresAt` | String | null | ISO 8601 timestamp, only when the poster set one |
| `searchCategory` | String | null | Input echo |
| `scrapedAt` | String | ISO timestamp of the scrape |

### Example output

```json
{
    "dealId": "3388281",
    "title": "[Clients Sosh] Smartphone 6,3\" Google Pixel 10a 5G+ - RAM 8 Go, 128 Go (Via 120€ de Bonus Reprise & 50€ d'ODR sur Facture)",
    "url": "https://www.dealabs.com/bons-plans/google-pixel-10a-128go-lavande-uniquement-via-bonus-reprise-120eur-odr-orange-50eur-3388281",
    "scrapedAt": "2026-08-09T14:08:59.417Z",
    "price": 229,
    "originalPrice": null,
    "discountPercentage": null,
    "currency": "EUR",
    "merchantName": "Sosh",
    "shopDomain": "shop.sosh.fr",
    "imageUrl": "https://static-pepper.dealabs.com/threads/raw/w1dLd/3388281_1/re/768x768/qt/60/3388281_1.jpg",
    "temperature": 5020.14,
    "temperatureLevel": "Hot2",
    "commentCount": 554,
    "category": "High-Tech",
    "categorySlug": "high-tech",
    "voucherCode": null,
    "isExpired": false,
    "isHot": true,
    "isNew": false,
    "freeShipping": null,
    "publishedAt": "2026-08-06T08:22:53.000Z",
    "expiresAt": null,
    "searchCategory": "high-tech"
}
```

### Cost estimate

This actor uses approximately **1 request per 30 results** (one listing page = 30 deals), making it one of the cheapest scrapers in the fleet per item — well under $0.01 per 30 deals in Apify compute alone.

### Limitations

- No robots.txt-compliant keyword search exists on dealabs.com (its `/search` route and REST/GraphQL API are all disallowed for crawlers). This actor browses by category/keyword slug instead — the same path a visitor takes from the site's own category menu.
- `price` and `discountPercentage` are community-entered fields and are sometimes absent, approximate, or (rarely) inconsistent with the deal title — see the note above.
- `merchantName` is null on deals with no registered merchant page (blog posts, press releases, some freebies) — `shopDomain` is populated more reliably and is the better "who sells this" field.
- A run's usage cost only settles after the run reports SUCCEEDED — checking cost mid-run under-reports actual spend.
- Data is scraped from the public website and may change without notice.

### Related Scrapers

- [mydealz-scraper](https://apify.com/studioamba/mydealz-scraper) — same Pepper Group platform, German deals community
- [pepper-pl-scraper](https://apify.com/studioamba/pepper-pl-scraper) — same Pepper Group platform, Polish deals community
- [cdiscount-scraper](https://apify.com/studioamba) — French ecommerce marketplace, common dealabs merchant
- [fnac-scraper](https://apify.com/studioamba) — French electronics/media retailer, common dealabs merchant

### Need this data on a schedule, or a custom version?

We run this scraper as a managed service for businesses: scheduled runs, deduplication, delta detection, and delivery to your inbox, Google Sheets, or API — maintenance included. We can also build a custom version with your exact fields and filters, or combine multiple sources into one feed.

See [studioamba.dev/services](https://studioamba.dev/services/) or email <hello@studioamba.dev> for a free data sample. We maintain 300+ European web scrapers and answer within one business day.

# Actor input Schema

## `category` (type: `string`):

dealabs.com category slug, taken from the URL /groupe/{slug} (e.g. 'high-tech', 'maison-habitat', 'auto-moto', 'sports-plein-air', 'gratuit'). Many popular product names also work as their own slug since dealabs tags deals with both broad categories and specific product groups. Leave empty to scrape the site-wide homepage deals feed instead of one category.

## `maxResults` (type: `integer`):

Maximum number of deals to return. Results load in pages of 30.

## `proxyConfiguration` (type: `object`):

Proxy settings. Residential (France) recommended — dealabs.com's Cloudflare protection intermittently blocks Apify's automatic/datacenter proxy IPs even though it has no active JS challenge.

## Actor input object example

```json
{
  "category": "high-tech",
  "maxResults": 30,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "FR"
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "category": "high-tech",
    "maxResults": 30,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "FR"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/dealabs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "category": "high-tech",
    "maxResults": 30,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "FR",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/dealabs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "category": "high-tech",
  "maxResults": 30,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "FR"
  }
}' |
apify call studio-amba/dealabs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/dealabs-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/UbJFLB5QSD8ryhs4X/builds/LoC3pOPL7gF8nbcj2/openapi.json