# Coop Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/coop/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 3 credits per call |
| **Documentation** | https://www.piloterr.com/library/coop-product |

## Description

Extract complete product details from Coop Switzerland including price, nutrition facts, origin, labels, images, and stock status.

## 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/coop/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Product by URL (Clémentines 1 kg)

```json
{
  "ean": "7610200834512",
  "url": "https://www.coop.ch/fr/alimentation/fruits-legumes/agrumes/clementines-et-mandarines/clementines-1-kg/p/0000000003090325",
  "name": "Clémentines",
  "slug": "clementines-1-kg",
  "brand": null,
  "price": "3.95",
  "labels": [
    "IP-SUISSE",
    "Rainforest Alliance"
  ],
  "origin": "Espagne",
  "rating": 4.5,
  "weight": "1 kg",
  "category": "Alimentation",
  "currency": "CHF",
  "in_stock": true,
  "allergens": [],
  "image_url": "https://www.coop.ch/etc.clientlibs/coop-core/clientlibs/de/production/img/productManagement/10933-webProductImg-3090325-default-v1-x-small.jpg",
  "product_id": "3090325",
  "description": "Nos clémentines sont juteuses et sucrées, idéales pour une collation saine et savoureuse. Issues de cultures responsables.",
  "is_promotion": false,
  "review_count": 73,
  "sub_category": "Fruits & Légumes",
  "nutrition_info": {
    "fat": "0.2 g",
    "energy": "190 kJ",
    "sodium": "0.01 g",
    "sugars": "10 g",
    "protein": "0.8 g",
    "carbohydrates": "10 g",
    "dietary_fiber": "1.7 g",
    "saturated_fat": "0.1 g"
  },
  "price_per_unit": "3.95 CHF / kg",
  "recycling_info": "Emballage filet recyclable.",
  "promotion_label": null,
  "promotion_price": null,
  "sub_sub_category": "Agrumes > Clémentines et Mandarines",
  "additional_images": [
    "https://www.coop.ch/etc.clientlibs/coop-core/clientlibs/de/production/img/productManagement/10933-webProductImg-3090325-default-v1-small.jpg",
    "https://www.coop.ch/etc.clientlibs/coop-core/clientlibs/de/production/img/productManagement/10933-webProductImg-3090325-alt-v1-x-small.jpg"
  ],
  "storage_instructions": "Conserver à température ambiante ou dans le bac à légumes du réfrigérateur."
}
```

## Documentation

## Overview
The Coop Product API delivers a complete, structured data sheet for any product sold on Coop Switzerland. Pass a product URL or a Coop product ID and instantly receive pricing, promotional status, certification labels (Bio, Fair Trade, IP-SUISSE), nutritional facts, stock availability, customer ratings, and high-resolution image URLs, all from a single API call.

## Quickstart
```
GET https://api.piloterr.com/v2/coop/product?query=3090325
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full Coop.ch product URL or numeric product ID |

## Response fields
| Field | Type | Description |
|---|---|---|
| `product_id` | string | Unique numeric Coop product identifier |
| `name` | string | Full product name |
| `price` | string | Regular shelf price (CHF) |
| `is_promotion` | boolean | Whether the product is on sale |
| `promotion_price` | string | Discounted price if active |
| `labels` | array | Quality and certification labels |
| `in_stock` | boolean | Current online availability |
| `origin` | string | Country or region of origin |
| `allergens` | array | Declared allergens |
| `nutrition_info` | object | Full nutritional facts per 100 g |
| `rating` | number | Average customer rating (1.0–5.0) |
| `image_url` | string | Main product image URL |

## Notes
- Both product URLs and numeric IDs are accepted
- Non-food products may return an empty `nutrition_info`

## Main use cases
- Enrich internal product databases with complete Coop data including nutrition facts and pricing
- Track price changes and promotional cycles for specific SKUs on Coop Switzerland
- Build compliance tools that verify origin, allergens, and certifications for Swiss grocery products
- Automate product content syndication for comparison sites, apps, or retail marketplaces
- Monitor stock availability of key products to trigger automated reordering alerts