# Penny.de Offers Scraper (`axiomworks/penny-offers-scraper`) Actor

Collect offer data from Penny.de for the current, next or a specified week. Results include each offer’s title, category, price, original price and discount when shown, quantity, unit price, image and link. Category filters let you limit results to selected sections.

- **URL**: https://apify.com/axiomworks/penny-offers-scraper.md
- **Developed by:** [Axiom Works](https://apify.com/axiomworks) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.60 / 1,000 results

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

**Returns:** one row per offer with `title`, `category`, `price`, `originalPrice`, `discount`, `quantity`, `basePrice`, `imageUrl`, `offerUrl`, `week`.
**Input:** `{"week": "current", "categories": ["top-angebote"], "maxItems": 50}`
**Best for:** grocery price monitoring, weekly deal comparison, discount alert feeds.

```json
{
    "title": "RED BULL Energy-Drink*",
    "category": "top-angebote",
    "price": 0.99,
    "originalPrice": 1.49,
    "discount": "33%",
    "quantity": "je 250 ml",
    "week": "2026-41",
    "offerUrl": "https://www.penny.de/angebote/top-angebote/red-bull-energy-drink"
}
```

### What does Penny.de Offers Scraper do?

Penny.de Offers Scraper is a Penny scraper and unofficial Penny API for the weekly supermarket offers published on penny.de/angebote. It collects every offer tile for the current week, the next week or a specific week, across all categories or only the ones you pick. Each row has the title, the offer price, the original price and discount when the tile shows them, the pack size, the unit price, the image and the link to the offer page.

The data comes from public pages, no login needed. The Actor reads the category list and the current week from the offers page, then requests one JSON list per category. That is roughly one request per category, so a full run over all categories is about 25 requests, sent at a modest pace.

Typical uses are building a weekly price list for German grocery deals, tracking which products are discounted and by how much, comparing Penny offers with other retailers, and feeding a deal newsletter or a spreadsheet. Results export as JSON, CSV, Excel, XML or HTML from the dataset, and you can schedule the Actor to run every week.

### What data can you get from Penny.de?

Every record contains the fields below. Some fields are empty when a tile does not show them, for example `originalPrice` and `discount` are only present on discounted offers.

| Field | Description | Example |
|---|---|---|
| `id` | Stable offer UUID assigned by Penny | `322b3a83-659a-4156-8b7b-83ada0379292` |
| `title` | Offer title as shown on the tile | `RED BULL Energy-Drink*` |
| `category` | Offer category slug | `top-angebote` |
| `price` | Offer price in euros, footnote markers removed | `0.99` |
| `originalPrice` | Crossed-out or recommended price in euros, when shown | `1.49` |
| `discount` | Discount percentage, when shown | `33%` |
| `quantity` | Pack size or quantity text | `je 250 ml` |
| `basePrice` | Price per unit as displayed | `(1 l = 3.96)` |
| `imageUrl` | URL of the offer image | `https://cdn.penny.de/dam/jcr:a06ab81f-3df6-44c4-a8a5-8c07a4f3bc00/55748200.png?impolicy=penny&imwidth=600` |
| `offerUrl` | Link to the offer page on penny.de | `https://www.penny.de/angebote/top-angebote/red-bull-energy-drink` |
| `week` | Offer week slug | `2026-41` |
| `sourceUrl` | API endpoint the offer was collected from | `https://www.penny.de/.rest/offers/by-category/2026-41/top-angebote` |

### How to use Penny.de Offers Scraper

1. Open the Actor in Apify Console and go to the Input tab.
2. Choose the week: `current`, `next`, or a week slug such as `2026-41`.
3. Optionally list categories, one per line: slugs, German names such as `Obst & Gemüse`, or links to penny.de/angebote. Leave the list empty to scrape every category.
4. Set `maxItems` to cap the number of offers.
5. Click Start, then export the dataset as JSON, CSV or Excel when the run finishes.

Tips: category slugs are the last part of the URL on penny.de/angebote, for example `top-angebote`, `fleisch-und-wurst`, `getraenke` or `kuehlregal`. Some categories have numbered variants for different offer periods, such as `getraenke1` for offers from Thursday; asking for `getraenke` includes them. Common English words like `drinks` or `dairy` are mapped to the matching Penny category. The same product can appear in more than one category with a different `id`. The next week is only available once Penny has published it; until then the run returns the current week and says so in the log, and the `week` field of each row shows the week you actually got.

#### Choosing the week

The `week` input accepts three kinds of values. The value `current` makes the Actor read the current week from the offers page, so a scheduled run always follows the live offers without you changing anything. The value `next` uses the following week when Penny has already published it, which is handy for planning a shopping list or preparing a newsletter before the offers start. A slug such as `2026-41` (also written `2026-W41` or `KW41`) asks for that exact week. The site only serves the live week and, shortly before it starts, the next one. If you ask for a week one or two weeks away that is not online, the run returns the current week instead and logs a warning; a week further away ends with zero results and a status message.

#### Working with the output

Each row is one offer tile. The `price` and `originalPrice` fields are numbers in euros, so you can sort, filter and compute savings directly in a spreadsheet or a database. The `discount` field keeps the percentage text as a string. The `quantity` and `basePrice` fields are kept exactly as displayed on the tile, which means they contain the German wording, for example `je 250 ml` for a single can or `(1 l = 3.96)` for the price per litre. If you need the unit price as a number, parse the figure after the equals sign.

Because the `id` is the offer identifier assigned by Penny, you can use it to join runs from different weeks or to detect new offers between two runs. The `offerUrl` points to the product offer page on penny.de, and `imageUrl` points to a large version of the product image.

### Input

| Field | Type | Required | Description |
|---|---|---|---|
| `week` | string | No | `current`, `next` or a week slug like `2026-41`. Default `current`. |
| `categories` | array of strings | No | Category slugs, names or penny.de/angebote links to scrape, including their period variants. Empty means all categories. |
| `searchTerms` | string\[] | No | Keywords matched against the offer title (case-insensitive, any term matches), e.g. `["Kaffee"]`. Empty returns every offer. |
| `maxItems` | integer | No | Maximum number of offers to return, 1-10000, default 50. |
| `proxyConfiguration` | object | No | Proxy settings. Default: no proxy; enable Apify Proxy if requests are blocked. |

```json
{
    "week": "current",
    "categories": ["top-angebote", "fleisch-und-wurst"],
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": false }
}
```

### Output

Two real records from a test run are shown below. Download the dataset as JSON, CSV, Excel, XML or RSS.

```json
[
    {
        "id": "322b3a83-659a-4156-8b7b-83ada0379292",
        "title": "RED BULL Energy-Drink*",
        "category": "top-angebote",
        "price": 0.99,
        "originalPrice": 1.49,
        "discount": "33%",
        "quantity": "je 250 ml",
        "basePrice": "(1 l = 3.96)",
        "imageUrl": "https://cdn.penny.de/dam/jcr:a06ab81f-3df6-44c4-a8a5-8c07a4f3bc00/55748200.png?impolicy=penny&imwidth=600",
        "offerUrl": "https://www.penny.de/angebote/top-angebote/red-bull-energy-drink",
        "week": "2026-41",
        "sourceUrl": "https://www.penny.de/.rest/offers/by-category/2026-41/top-angebote"
    },
    {
        "id": "838ad134-7503-408e-9707-9afac900655e",
        "title": "OATLY Haferdrink*",
        "category": "top-angebote",
        "price": 1.79,
        "originalPrice": 2.55,
        "discount": "29%",
        "quantity": "je 1 I",
        "basePrice": null,
        "imageUrl": "https://cdn.penny.de/dam/jcr:5d732984-3391-4ff7-ade7-ec9c77b73e0b/50488192.png?impolicy=penny&imwidth=600",
        "offerUrl": "https://www.penny.de/angebote/top-angebote/oatly-haferdrink",
        "week": "2026-41",
        "sourceUrl": "https://www.penny.de/.rest/offers/by-category/2026-41/top-angebote"
    }
]
```

#### Filtering by keyword

Set `searchTerms` to keep only offers whose `title` contains one of the keywords, for example `{"week": "current", "searchTerms": ["Kaffee", "Butter"], "maxItems": 50}`. The filter runs on the categories you chose (or all categories when none is given), so it also works for price monitoring of a single product.

### How much does it cost to scrape Penny.de?

Penny.de Offers Scraper is charged per result. You pay only for the results returned, and `maxItems` caps how many that can be. See the Pricing tab for the current price.

### Use with AI agents (MCP)

Connect Penny.de Offers Scraper to Claude, Cursor or any MCP client through the Apify MCP server:

```json
{
    "mcpServers": {
        "apify": {
            "url": "https://mcp.apify.com/?tools=axiomworks/penny-offers-scraper"
        }
    }
}
```

Example prompts:

1. "Get this week's Penny offers in the getraenke category and list the three biggest discounts."
2. "Scrape the first 30 Penny offers for next week and put them in a table with price and quantity."
3. "Which Penny meat and sausage offers this week cost less than 3 euros?"

### Integrations and API

Run Penny.de Offers Scraper from your own code with the Apify API. Set `APIFY_TOKEN` to your Apify API token (send it in the `Authorization` header, never in the URL).

**Python**

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("axiomworks/penny-offers-scraper").call(run_input={"week": "current", "categories": ["top-angebote"], "maxItems": 50})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**JavaScript**

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

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const run = await client.actor('axiomworks/penny-offers-scraper').call({ week: 'current', categories: ['top-angebote'], maxItems: 50 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

**cURL**

```bash
curl -X POST "https://api.apify.com/v2/acts/axiomworks~penny-offers-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"week": "current", "categories": ["top-angebote"], "maxItems": 50}'
```

You can also connect the Actor to Make, Zapier, n8n, Google Sheets or webhooks from the Integrations tab, and schedule weekly runs so your sheet updates when Penny publishes new offers.

### FAQ

**How fresh is the data?**
Each run reads the live offers on penny.de at the time it runs. Penny changes its offers weekly, so a weekly schedule is usually enough.

**Why did my run return 0 results?**
Either a category slug does not exist this week, or the week you asked for is far from the current one. The run status message says what to change. Check slugs on penny.de/angebote.

**Why is `originalPrice` or `discount` empty?**
Only discounted tiles show an original price and a percentage. Other offers have these fields empty.

**Why do prices have no footnote marks?**
Some tiles show prices like 0.69 followed by a footnote symbol. The scraper keeps the number only.

**Can I get all categories at once?**
Yes. Leave `categories` empty and every category listed on the offers page is scraped until `maxItems` is reached.

**Do I need a proxy?**
Usually not. If requests get blocked, enable Apify Proxy in the proxy settings; blocked requests are retried on a new IP automatically.

**Are store-specific offers included?**
No. The Actor collects the national weekly offers listed on the offers page, not offers for a single store.

**Does it collect prices for a specific store or postcode?**
No. Penny publishes national weekly offers on this page, and that is what the Actor collects. Store specific stock and prices are not part of the data.

**Can I run it on a schedule?**
Yes. Use the Schedules feature in Apify Console and run it once a week with `week` set to `current`. Combine it with a webhook or an integration to push the new rows into your tools automatically.

**What happens if a category name is wrong?**
The Actor logs which category was not found, continues with the other categories, and finishes successfully. If none of the categories exist, the run ends with zero results and a message that tells you to check the slugs on the offers page.

**How many requests does a run make?**
One request for the offers page and one per category, sent about once per second. A run over every category therefore makes about twenty-five requests in total, which keeps the load on the site small.

### Is it legal to scrape Penny.de?

This Actor collects only publicly available offer data that anyone can see on the website without logging in. You are responsible for how you use the data, including compliance with applicable laws and the site's terms. This is not legal advice. This Actor is an independent tool and is not affiliated with or endorsed by Penny or its owner.

### Feedback

Found a bug or need a field that isn't here? Open an issue on the Issues tab and we'll look at it.

# Actor input Schema

## `week` (type: `string`):

Offer week to scrape: 'current' (this week), 'next' (next week; falls back to the current week if Penny hasn't published it yet) or a week like '2026-41'. Default 'current'.

## `categories` (type: `array`):

Categories to scrape, one per line: slugs from penny.de/angebote such as 'top-angebote', 'fleisch-und-wurst', 'getraenke', 'kuehlregal', or names like 'Obst & Gemüse'. Each includes its period variants (getraenke1). Leave empty to scrape all categories.

## `searchTerms` (type: `array`):

Optional keywords, one per line, e.g. 'Kaffee', 'Butter'. Only offers whose title contains any of them (case-insensitive) are returned. Leave empty to return every offer in the chosen categories.

## `maxItems` (type: `integer`):

Maximum number of offers to return across all categories, 1-10000, default 50. The run stops as soon as this many are saved, and you are charged only for results returned.

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

Proxy to use for requests. Penny.de usually works without a proxy; enable Apify Proxy if requests get blocked.

## Actor input object example

```json
{
  "week": "current",
  "categories": [
    "top-angebote",
    "fleisch-und-wurst"
  ],
  "searchTerms": [],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset with one item per result, in the order found.

# 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 = {
    "week": "current",
    "categories": [
        "top-angebote",
        "fleisch-und-wurst"
    ],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("axiomworks/penny-offers-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 = {
    "week": "current",
    "categories": [
        "top-angebote",
        "fleisch-und-wurst",
    ],
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("axiomworks/penny-offers-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 '{
  "week": "current",
  "categories": [
    "top-angebote",
    "fleisch-und-wurst"
  ],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call axiomworks/penny-offers-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,axiomworks/penny-offers-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/xnMhJEb9dIziB4uHF/builds/u6PZkKzD04ZDhxFEV/openapi.json