# Digitec Galaxus Scraper - Products, Prices & Specs (CH/DE) (`abotapi/galaxus-marketplace-scraper`) Actor

Scrape Digitec Galaxus, Switzerland's largest online retailer: products with local prices, discounts, ratings, stock state and full specification tables across the galaxus.ch, galaxus.de and digitec.ch storefronts. Search keywords or paste links, and monitor price changes with recurring updates.

- **URL**: https://apify.com/abotapi/galaxus-marketplace-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 product 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

## Digitec Galaxus Scraper

Collect product records from the Digitec Galaxus storefronts: Galaxus Switzerland, Galaxus Germany and Digitec Switzerland. Each record carries the local price and currency, discount, rating, availability and promotion info, with an optional detail read that adds the description, summary bullets, full specification table, warranty, gallery images, data sheet link and test report grade.

### Modes

- **Keyword search**: pick a storefront, type one or more search terms. Each search is walked forward and all searches share the record cap. A term the store maps to a whole category is walked as that category, exactly what a shopper sees.
- **My own links**: paste product page links for one enriched record each, or category links for a forward walk. Each link is read on its own storefront, regardless of the storefront selector.

### Useful inputs

- `market`: which storefront to search (Swiss shops price in CHF, the German shop in EUR).
- `sortBy`: relevance, newest, lowest price, highest price, rating, availability.
- `minPrice`, `maxPrice`: price range, applied by the store in both modes.
- `fetchDetails`: read each product page data as well. Each product read this way is billed one `detail-enrichment` event on top of the per record price. A read that fails keeps the listing record and charges nothing.
- `maxItems`: stop after this many records across the whole run (0 means no limit, the walk ends when the catalogue runs out). This is the single limit that stops a run.
- `maxPages`: guardrail on reads per source. Leave 0 to go as deep as the source serves.

### Recurring updates

Set `incrementalMode` for daily or weekly monitoring. The first run returns everything as NEW. Later runs return only NEW, UPDATED and REAPPEARED records, each labelled in a `changeType` column with `changedFields`, `firstSeenAt` and `lastSeenAt`. Prices, ratings and stock move constantly on this store, so a record whose only difference is a price still counts as UPDATED.

- `stateKey`: name a monitoring campaign to keep its memory stable. Leave empty and the memory is keyed on the run setup automatically.
- `emitUnchanged`: also return records that did not change, labelled UNCHANGED. This returns, and bills, rows you already have.
- `emitExpired`: also return records that are gone, labelled EXPIRED. Only produced when a run covered its whole setup, so a capped run never reports records as gone. This returns, and bills, extra rows.
- `resumeFromRunId`: continue one interrupted run. Records the earlier run already returned are skipped.

### Send results into your apps (MCP connectors)

Optionally pipe results into the apps you already use, after the scrape. Authorize a connector under Apify Settings, API and Integrations, then select it in `mcpConnectors`. Notion gets a rich page per item export through `notionParentPageUrl`, other connectors get a best effort write or digest capped by `maxNotifyListings`. Leave empty to skip. This never changes the dataset output.

### Sample output (illustrative placeholders, not live listings)

| name | brand | price | currency | availability |
|---|---|---|---|---|
| Sample Product 000000000 | Sample Brand | 499.00 | CHF | Available |
| Sample Product 000000001 | Sample Brand | 129.90 | EUR | Available |

A detail enriched record additionally carries `description`, `summary`, `keySpecifications`, `specifications`, `warranty`, `returnPolicy`, `imageUrls`, `dataSheetUrl`, `testReportCount` and `testReportGrade`.

### Cost and connection

Pricing is pay per event: one event per product record, one `detail-enrichment` event per product page read, plus the run start event. The store answers ordinary connections, so the default connection works and you can also bring your own links.

### Legal note

This actor reads publicly visible catalogue pages for your own analysis. Respect the store terms and applicable law. It is an independent tool with no affiliation with the store operator.

# Actor input Schema

## `mode` (type: `string`):

Where to collect from: a keyword search on one storefront, or your own product and category links.

## `market` (type: `string`):

Which storefront to search. Each storefront is its own catalogue with its own currency (Swiss Francs on the Swiss shops, euros on the German shop).

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

Only read when mode = keyword search. One entry per search; each search is walked forward, and all searches share the record cap.

## `sortBy` (type: `string`):

Order in which products are returned for each source.

## `minPrice` (type: `integer`):

Only return products at or above this price, in the selected storefront's currency. Applied by the store in both modes; price ranges on very large categories are server-side counts, so a wide range narrows strongly.

## `maxPrice` (type: `integer`):

Only return products at or below this price, in the selected storefront's currency. Applied by the store in both modes.

## `urls` (type: `array`):

Only read when mode = my own links. Paste category links (a product type such as Notebooks, a tag or an offer page) for a forward walk, or single product page links for one enriched product each. Each link is read on its own storefront.

## `fetchDetails` (type: `boolean`):

Read each product's own page data and add the description, summary bullets, full specification table, key specifications, warranty, gallery images, data-sheet link and test-report grade to the record. Off by default: a run without it is cheaper and still carries prices, discounts, ratings, availability and promotion info.

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

Stop after this many records across the whole run (0 = no limit; the walk then ends when the catalogue runs out).

## `maxPages` (type: `integer`):

Guardrail bound on how many reads any single search or category walk may spend. Leave 0 to go as deep as the source serves, with the record cap above as the only real limit.

## `resumeFromRunId` (type: `string`):

Paste the run id (or dataset id) of an earlier run of this Actor to continue it. Records that run already returned are skipped, so an interrupted large collection can finish without paying for the same rows twice. Leave empty for a normal run.

## `incrementalMode` (type: `boolean`):

Turn this on for daily or weekly monitoring. The first run returns everything as NEW. Later runs return only NEW, UPDATED and REAPPEARED records, each labelled in a changeType column. Prices, ratings and stock move constantly here, so a record whose only difference is a price still counts as UPDATED. Leave off for a normal one-off run.

## `stateKey` (type: `string`):

Optional. Name this monitoring campaign to keep its memory stable, or to deliberately share one memory across differently configured runs. Leave empty and the memory is keyed on the run setup automatically.

## `emitUnchanged` (type: `boolean`):

Off by default. Turn on to also return records that have not changed since the last run, labelled UNCHANGED. This returns, and bills, rows you already have.

## `emitExpired` (type: `boolean`):

Off by default. Turn on to also return records that were present before and are no longer found, labelled EXPIRED. Only produced when a run covered its whole setup, so a capped or continued run never reports records as gone. This returns, and bills, extra rows.

## `mcpConnectors` (type: `array`):

Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a rich page-per-item export; other connectors get a best-effort write or digest. Leave empty to skip; never changes the dataset output.

## `notionParentPageUrl` (type: `string`):

URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors.

## `maxNotifyListings` (type: `integer`):

Cap on items written to each connector per run. Does not affect the dataset.

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

Connection used for every request. The storefront answers ordinary connections, so the plain default works; you can also paste your own connection links.

## Actor input object example

```json
{
  "mode": "search",
  "market": "galaxus-ch",
  "searchTerms": [
    "laptop"
  ],
  "sortBy": "relevance",
  "urls": [
    "https://www.galaxus.ch/en/s1/producttype/notebooks-6"
  ],
  "fetchDetails": false,
  "maxItems": 20,
  "maxPages": 0,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "maxNotifyListings": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (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 = {
    "mode": "search",
    "market": "galaxus-ch",
    "searchTerms": [
        "laptop"
    ],
    "sortBy": "relevance",
    "urls": [
        "https://www.galaxus.ch/en/s1/producttype/notebooks-6"
    ],
    "fetchDetails": false,
    "maxItems": 20,
    "maxPages": 0,
    "incrementalMode": false,
    "emitUnchanged": false,
    "emitExpired": false,
    "maxNotifyListings": 50,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/galaxus-marketplace-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 = {
    "mode": "search",
    "market": "galaxus-ch",
    "searchTerms": ["laptop"],
    "sortBy": "relevance",
    "urls": ["https://www.galaxus.ch/en/s1/producttype/notebooks-6"],
    "fetchDetails": False,
    "maxItems": 20,
    "maxPages": 0,
    "incrementalMode": False,
    "emitUnchanged": False,
    "emitExpired": False,
    "maxNotifyListings": 50,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/galaxus-marketplace-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 '{
  "mode": "search",
  "market": "galaxus-ch",
  "searchTerms": [
    "laptop"
  ],
  "sortBy": "relevance",
  "urls": [
    "https://www.galaxus.ch/en/s1/producttype/notebooks-6"
  ],
  "fetchDetails": false,
  "maxItems": 20,
  "maxPages": 0,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "maxNotifyListings": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call abotapi/galaxus-marketplace-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/galaxus-marketplace-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/kGeNVFhdlLu6GS2lp/builds/Jz0QTcR2trSz3A6r5/openapi.json