# Pepco Scraper - Product Prices Across 16 European Shops (`studio-amba/pepco-scraper`) Actor

Scrape product data from the Pepco web shops in Poland, Czechia, Slovakia, Hungary, Romania, Bulgaria, Croatia, Slovenia, the Baltics, Serbia, Italy, Spain, Portugal and Greece. Get prices, currency, category paths, collections and images for every product.

- **URL**: https://apify.com/studio-amba/pepco-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **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/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

## Pepco Scraper

Pull product data from the Pepco web shops. Pepco is a European discount retailer for clothing, home, kids and toys. The actor returns one row per product with the price, currency, category path, collections and images, for any of 16 country shops.

Pepco runs the same web shop in every country, with its own domain, language and currency: pepco.pl, pepco.cz, pepco.sk, pepco.hu, pepco.ro, pepco.bg, pepco.hr, pepco.si, pepco.lt, pepco.lv, pepco.ee, pepco.rs, pepco.it, pepco.es, pepco.pt and pepco.gr. You choose the country in the input and get that shop's catalogue.

### How to scrape Pepco data

There are two ways to tell the actor which products to read.

1. Paste product pages into `productUrls`, for example `https://pepco.pl/products/pachnaca-swieca-w-szkle-633051`. The addresses must belong to the country you chose.
2. Leave `productUrls` empty and fill `urlKeywords`. The actor reads the shop's public product list (the sitemap) and keeps products whose address contains one of your words, in the language of the shop. Examples: `swieca` for Poland, `svicka` for Czechia, `lumanare` for Romania. Words are lowercase without accents, as they appear in the product addresses.

The actor stops at `maxResults`. If you leave everything empty, it reads the first 50 products in the product list of the chosen country.

The shop's search pages, cart, checkout and sorted category lists are not read. The site's robots.txt does not allow them, so the actor does not request them.

### Input

| Field | Type | Description |
|---|---|---|
| `country` | select | Pepco shop to read. Default `pl` |
| `productUrls` | list of URLs | Pepco product pages of the chosen country |
| `urlKeywords` | list of words | Used when no URLs are given. Keeps products whose address contains one of the words |
| `maxResults` | number | Maximum number of products to return. Default 50 |
| `proxyConfiguration` | proxy | Apify Proxy settings. Default is Apify Proxy |

### What you get back

Each row is one product.

| Field | Description |
|---|---|
| `plu` | Pepco article number, the number at the end of the product address |
| `partNumber` | Retailer part number including the variant suffix |
| `name` | Product name in the language of the shop |
| `description` | Product description from the page |
| `category` | Category path, top level first |
| `categorySlug` | Pepco's internal category code, the same in every country |
| `collections` | Collections the product belongs to |
| `price` | Current price including VAT |
| `currency` | PLN, CZK, EUR, HUF, RON, BGN, RSD or another local currency |
| `imageUrl` | Main product image |
| `images` | All product images |
| `url` | Product page |
| `scrapedAt` | Time of the request |
| `country` | Two-letter shop country code |
| `language` | Language of the page |

The product pages do not publish brand, EAN barcodes, stock or promotion prices, so the actor does not return them. Pepco sells most of its range as own brand.

### Example output

```json
{
  "plu": "633051",
  "partNumber": "63305101",
  "name": "Vonná svíčka",
  "description": "Tato vonná svíčka je klasika s romantickým nádechem. Jedině v Pepco!",
  "category": "Domov > Obývací pokoj > Svíčky a difuzéry",
  "categorySlug": "home-living-room-candles-and-aroma-diffusors",
  "collections": ["Svíčky a difuzéry", "Domov", "Všechny produkty", "Obývací pokoj"],
  "price": 120,
  "currency": "CZK",
  "imageUrl": "https://cdn.shopify.com/s/files/1/0951/3592/4548/files/633051_01-10_33250804-9a50-45da-a64e-b234e696055a.jpg",
  "images": ["https://cdn.shopify.com/s/files/1/0951/3592/4548/files/633051_01-10_33250804-9a50-45da-a64e-b234e696055a.jpg"],
  "url": "https://pepco.cz/products/vonna-svicka-633051",
  "scrapedAt": "2026-11-15T20:37:51.874Z",
  "country": "cz",
  "language": "cs"
}
```

### Use cases

- Price comparison between countries: run the same keyword on several countries and match rows by `plu`. The PLU is the same in every country shop.
- Price monitoring: run the actor on a schedule with the same product addresses and compare the price over time.
- Assortment comparison: match Pepco categories and price points against Action, Gifi, KiK and other discount chains.
- Category research: export a keyword and look at the price spread in a country.
- Catalogue feeds: collect names, descriptions and images for a country shop.

### Cost and speed

The actor reads one page per product over plain HTTP and needs no browser. Reading the product list takes a few seconds. About 40 products take under a minute. Pricing is per result, see the pricing box on this page. The usage cost of a run only settles after the run reports SUCCEEDED, so a cost checked during the run is too low.

### Notes and limits

- Prices include VAT and are in the currency of the chosen country.
- The product list of each shop holds around 7,000 products.
- When you use `urlKeywords`, the actor reads at most three times `maxResults` addresses and returns the products that still have a page.
- Product names, descriptions and categories are in the language of the chosen shop.

### Frequently asked questions

#### Can I compare one product across countries?

Yes. The `plu` is the same in every country shop. Run the actor once per country and join the results on `plu`.

#### Does it return stock or discounts?

No. Pepco's product pages show a price only. There is no stock count and no struck-through price in the page.

#### Can I search by keyword?

Yes, with `urlKeywords`. The actor matches the words against the product addresses, which contain the product name. The shop's own search page is not used because robots.txt does not allow it.

#### Why do I get fewer rows than maxResults?

Your keywords match fewer products than `maxResults`, or some pages in the product list have no product data. Use a broader keyword or raise `maxResults`.

#### How often can I run it?

As often as you like. For price monitoring, a daily run on the same list of product addresses works well.

### Related scrapers

- Gifi Scraper: product prices and stock from the French discount retailer.
- Action Scraper: discount retail products and prices across European Action shops.
- Stark Scraper: building materials and prices in Denmark.

# Actor input Schema

## `country` (type: `string`):

Which Pepco web shop to read. Prices come in that country's currency.

## `productUrls` (type: `array`):

Product pages from the Pepco shop of the chosen country, for example https://pepco.pl/products/pachnaca-swieca-w-szkle-633051. Leave empty to read the shop's product list.

## `urlKeywords` (type: `array`):

Used when no product URLs are given. The actor reads the shop's product list and keeps products whose address contains one of these words, in the language of the chosen shop, lowercase without accents, e.g. swieca for Poland or svicka for Czechia. Leave empty to read the first products in the list.

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

Maximum number of products to return.

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

Proxy used for the requests. Default is Apify Proxy.

## Actor input object example

```json
{
  "country": "pl",
  "urlKeywords": [
    "swieca"
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

No description

# 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 = {
    "country": "pl",
    "urlKeywords": [
        "swieca"
    ],
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/pepco-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 = {
    "country": "pl",
    "urlKeywords": ["swieca"],
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/pepco-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 '{
  "country": "pl",
  "urlKeywords": [
    "swieca"
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/pepco-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/pepco-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/AHesxVqEYaFzeCBnn/builds/yOrVhbzuYymLyf9Pb/openapi.json
