# Zooplus Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/zooplus/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/zooplus-product |

## Description

Zooplus Product API. Fetch full pet product page data from a Zooplus URL or shopIdentifier. Returns pricing, images, description, brand, ratings and availability.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/zooplus/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Jumbopack Felix Tendres Effilés (620472) on zooplus.fr

```json
{
  "url": "https://www.zooplus.fr/shop/chats/boites_sachets_barquettes_chat/felix_boites_chat/tendres_effiles/620472",
  "brand": "Felix",
  "price": 45.49,
  "title": "Jumbopack Felix Tendres Effilés 120 x 85 g pour chat",
  "images": [
    "https://media.zooplus.com/bilder/2/800/171113_nestlegermaindc_jumbopack_felix_sogut_fleischmix_120x85g_hs_02_2.jpg",
    "https://media.zooplus.com/bilder/2/800/171598_pla_felix_so_gut_wie_es_aussieht_gemischte_vielfalt_hs_01_2.jpg",
    "https://media.zooplus.com/bilder/0/800/326501_pla_nestle_felix_so_gut_wie_es_aussieht_fleischfischmix_3_0.jpg"
  ],
  "rating": 3.5,
  "summary": "Felix \"Aussi bon que beau\" - Tendres Effilés disponible en jumbopack 120 x 85 g : aliment complet pour chat, disponible en plusieurs saveurs, morceaux juteux en gelée, sachets fraîcheur pratiques.",
  "category": "zooplus.fr > Chat > Boîtes et sachets pour chat > Sans poulet",
  "currency": "EUR",
  "in_stock": true,
  "image_url": "https://media.zooplus.com/bilder/2/800/171113_nestlegermaindc_jumbopack_felix_sogut_fleischmix_120x85g_hs_02_2.jpg",
  "product_id": "620472",
  "description": "Les sachets Felix \"Aussi bon que beau\" - Tendres Effilés, avec ses tendres morceaux en gelée, sauront vous convaincre vous et votre chat ! Cette nourriture pour chat sent bon et a une saveur incroyablement délicieuse.",
  "review_count": 92,
  "variant_count": 7
}
```

## Documentation

## Overview
The **Zooplus Product API** returns full product page data from Zooplus online shops. Pass a **product URL** or **`shopIdentifier`**, optionally with **`region`**, and receive structured JSON with pricing, images, description, brand, ratings, and availability.

Piloterr parses the Next.js SSR payload (`#__NEXT_DATA__`) from the HTML. No browser rendering required.

Use [Zooplus Search](https://www.piloterr.com/library/zooplus-search) to discover listings, then [Zooplus Product](https://www.piloterr.com/library/zooplus-product) for the full record.

## Supported regions
26 footer regions. Default: `fr` → `www.zooplus.fr`.

| `region` | Domain | Currency | Aliases |
|---|---|---|---|
| `fr` | zooplus.fr | EUR | `fr-fr` |
| `de` | zooplus.de | EUR | `de-de` |
| `gb` | zooplus.co.uk | GBP | `uk`, `en-gb` |
| `pl` | zooplus.pl | PLN | `pl-pl` |
| `cs` | zoohit.cz | CZK | `cz`, `cs-cz` |
| `ch-fr` | zooplus.ch/fr | CHF | `fr-ch` |
| … | see docs | … | 26 regions total |

`shopIdentifier`-only queries (`620472`) resolve via internal search on the target shop.

## Quickstart
```
GET https://api.piloterr.com/v2/zooplus/product?query=620472
GET https://api.piloterr.com/v2/zooplus/product?query=620472&region=fr
GET https://api.piloterr.com/v2/zooplus/product?query=https://www.zooplus.fr/shop/chats/boites_sachets_barquettes_chat/felix_boites_chat/tendres_effiles/620472
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Product URL or `shopIdentifier` |
| `region` | string | no | Country when `query` is id only (default: `fr`) |
| `return_page_source` | boolean | no | Raw HTML as `{"result": "..."}` (default: `false`) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `product_id` | string | `shopIdentifier` |
| `title` | string | Product title |
| `url` | string | Canonical product URL |
| `summary` | string \| null | Short teaser |
| `description` | string \| null | Long HTML description |
| `image_url` | string \| null | Main image |
| `images` | string[] \| null | Ordered gallery |
| `price` | number \| null | Current price |
| `old_price` | number \| null | Strikethrough price when on sale |
| `currency` | string | ISO currency |
| `brand` | string \| null | Brand name |
| `rating` | number \| null | Average rating |
| `review_count` | integer \| null | Review count |
| `variant_count` | integer \| null | Available variants |
| `in_stock` | boolean \| null | Online availability |
| `category` | string \| null | Breadcrumb path (`domain > …`) |

## Zooplus workflow
1. [Zooplus Search](https://www.piloterr.com/library/zooplus-search) to discover listings
2. [Zooplus Product](https://www.piloterr.com/library/zooplus-product) for full PDP JSON (this endpoint)

## Error codes
| Code | Meaning |
|---|---|
| `400` | Missing or invalid `query` / `region` |
| `404` | Unparsable or missing product page |
| `500` | Network or parsing error |

## Notes
- For `ch-fr`, product URLs may include a `/fr` prefix; the parser avoids double `/fr/fr/` paths.
- Costs **1 credit** per call (HTTP crawler).

## Main use cases
- **PDP enrichment**: description, gallery, brand, category breadcrumbs
- **Price monitoring**: `old_price` and variant-level pricing
- **Multi-country catalogs**: same `shopIdentifier` across Zooplus regional shops