# Zooplus Fr Scraper + (`xylonic_reef/zooplus-fr-scraper-1`) Actor

Scrappez zooplus.fr : code EAN/GTIN, marque, prix, ingrédients, additifs et analyse typique (protéines, matières grasses, fibres, cendres). Croquettes ou friandises pour chats et chiens, ou toute URL de catégorie. Scraping HTTP rapide, sans navigateur. Facturé au résultat.

- **URL**: https://apify.com/xylonic_reef/zooplus-fr-scraper-1.md
- **Developed by:** [Matthieu](https://apify.com/xylonic_reef) (community)
- **Security:** Full permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.0001 / actor start

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## Zooplus France Scraper

Scrapes product data from **zooplus.fr** — the EU's largest pet supplies e-shop.

### What you get (per product)

| Field | Example |
|---|---|
| `gtin` | `4062911049970` (EAN-13, from structured data) |
| `brand` | `Rocco` |
| `name` | `Rocco Chings Strings pour chien dinde 200 g` |
| `price` / `currency` | `3.49` / `EUR` |
| `species` | `cat`, `dog`, `horse` (from URL path) |
| `ingredients` | full ingredient list, cleaned |
| `additives` | additives section |
| `protein`, `fat`, `fiber`, `ash` | typical analysis in % (`7.0`) |
| `url`, `scrapedAt` | provenance |

### Input

- **Categories** — multi-select the zooplus.fr categories you want; combine
  as many as you like. Each selected category gets an equal share of
  **Max items** (leftover budget rolls over to the next source):

  | Option | URL scraped |
  |---|---|
  | Croquettes chat | `zooplus.fr/shop/chats/croquettes_chat` |
  | Croquettes chien | `zooplus.fr/shop/chiens/croquettes_chien` |
  | Friandises chat | `zooplus.fr/shop/chats/friandises_chat` |
  | Friandises chien | `zooplus.fr/shop/chiens/friandises_chien` |

- **Start URLs** — free-form list on top of the categories: paste any
  zooplus.fr **product URL** (that exact product is scraped) or **category
  URL** (every product link on the page is scraped). Remove the example
  entries with the ✕ button and add your own.

- **Max items** — stop early once N products are collected across all
  sources (default 100). Also caps your pay-per-result spending.

- **Delay between requests (ms)** — politeness delay (default 1200).

### Long runs, timeouts & resurrect

At ~1.2 s per product page, a 500-item run takes ~15 min. The default platform
timeout (often 300 s) kills the run around item ~110 — **raise the Timeout run
option** (e.g. 3600 s) for anything above ~200 items.

If a run still dies and you resurrect it, the Actor **resumes instead of
restarting**: delivered product URLs are persisted to the key-value store
every 10 items and skipped on the next run. A resurrect continues where the
previous attempt stopped instead of pushing the same first items again. To
force a fresh full re-scrape, delete the `scraped-urls` record in the run's
key-value store.

### Pricing — pay per result

This Actor is billed per **scraped product**: each successfully scraped and
delivered item charges one `result` event. Failed fetches and unparsed pages
are never charged. If your account's spending limit is hit mid-run, the Actor
stops early instead of producing unbilled work — use **Max items** to cap a
run's cost precisely. See the Pricing tab for the exact per-result price.

### Why this one

- **French AND English pages** handled — composition sections use
  localized anchors (`Ingrédients` / `Ingredients`, `Constituants
  analytiques` / `Analytical constituents`, `Mode d'emploi` / `Feeding
  guide`) and tolerate real-world formatting (`Protéine brute : 62 %`).
- **Plain HTTP, no headless browser** — fast, cheap, no proxy burn.
- **EAN from JSON-LD**, not scraped heuristics — barcode-clean output,
  ready for price feeds and product catalogs.

### Notes

- Categories list ~40-50 products per page; give deeper subcategory URLs
  (or several URLs) for broader coverage.
- Personal-use tip: keep the delay at 1200 ms or above — the HTTP-only
  crawler is light on compute units, so runs stay cheap.

# Actor input Schema

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

Zooplus.fr categories to scrape - combine as many as you like (each selected category gets an equal share of Max items). Leave empty to rely only on Start URLs.

## `startUrls` (type: `array`):

Any zooplus.fr product or category URLs. A product URL is scraped as-is (that single product); a category URL yields every product link found on the page. Remove the examples with the x button, add your own.

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

Maximum number of products to scrape across all sources (stop early once reached). Also caps your pay-per-result spending.

## `delayMs` (type: `integer`):

Politeness delay between product page fetches.

## Actor input object example

```json
{
  "categories": [
    "croquettes-chat",
    "croquettes-chien",
    "friandises-chat",
    "friandises-chien"
  ],
  "startUrls": [
    {
      "url": "https://www.zooplus.fr/shop/chats/friandises_chat/friandises_deshydratees_naturelles_chat/cosma/605807"
    },
    {
      "url": "https://www.zooplus.fr/shop/chats/friandises_chat/friandises_deshydratees_naturelles_chat/friandises_purizon/752106"
    }
  ],
  "maxItems": 100,
  "delayMs": 1200
}
```

# Actor output Schema

## `products` (type: `string`):

Dataset containing all scraped products

# 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 = {
    "categories": [
        "croquettes-chat",
        "croquettes-chien",
        "friandises-chat",
        "friandises-chien"
    ],
    "startUrls": [
        {
            "url": "https://www.zooplus.fr/shop/chats/friandises_chat/friandises_deshydratees_naturelles_chat/cosma/605807"
        },
        {
            "url": "https://www.zooplus.fr/shop/chats/friandises_chat/friandises_deshydratees_naturelles_chat/friandises_purizon/752106"
        }
    ],
    "maxItems": 100,
    "delayMs": 1200
};

// Run the Actor and wait for it to finish
const run = await client.actor("xylonic_reef/zooplus-fr-scraper-1").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 = {
    "categories": [
        "croquettes-chat",
        "croquettes-chien",
        "friandises-chat",
        "friandises-chien",
    ],
    "startUrls": [
        { "url": "https://www.zooplus.fr/shop/chats/friandises_chat/friandises_deshydratees_naturelles_chat/cosma/605807" },
        { "url": "https://www.zooplus.fr/shop/chats/friandises_chat/friandises_deshydratees_naturelles_chat/friandises_purizon/752106" },
    ],
    "maxItems": 100,
    "delayMs": 1200,
}

# Run the Actor and wait for it to finish
run = client.actor("xylonic_reef/zooplus-fr-scraper-1").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 '{
  "categories": [
    "croquettes-chat",
    "croquettes-chien",
    "friandises-chat",
    "friandises-chien"
  ],
  "startUrls": [
    {
      "url": "https://www.zooplus.fr/shop/chats/friandises_chat/friandises_deshydratees_naturelles_chat/cosma/605807"
    },
    {
      "url": "https://www.zooplus.fr/shop/chats/friandises_chat/friandises_deshydratees_naturelles_chat/friandises_purizon/752106"
    }
  ],
  "maxItems": 100,
  "delayMs": 1200
}' |
apify call xylonic_reef/zooplus-fr-scraper-1 --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,xylonic_reef/zooplus-fr-scraper-1"
        }
    }
}
```

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/FmdjvbdNFPZkjvgXf/builds/tMcmozpkSjep1OTmP/openapi.json