# Coop Search

## Overview

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

## Description

Search and extract real-time product listings from Coop Switzerland with prices, categories, labels, promotions, and images.

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

## Example Response

### Search for 'chocolat noir'

```json
{
  "query": "chocolat noir",
  "results": [
    {
      "brand": "Coop Fine Food",
      "labels": [
        "Rainforest Alliance"
      ],
      "rating": 4.6,
      "weight": "100 g",
      "category": "Alimentation",
      "productId": "7634892",
      "isAvailable": true,
      "isPromotion": false,
      "productName": "Coop Fine Food Chocolat Noir 85% Cacao",
      "reviewCount": 128,
      "subCategory": "Chocolat & Confiserie",
      "productPrice": "3.95 CHF",
      "promotionPrice": null,
      "productImageURL": "https://www.coop.ch/etc.clientlibs/coop-core/clientlibs/de/production/img/productManagement/10933-webProductImg-7634892-default-v1-x-small.jpg",
      "productDetailsURL": "https://www.coop.ch/fr/alimentation/chocolat-confiserie/chocolat/coop-fine-food-chocolat-noir-85-cacao-100g/p/0000000007634892"
    },
    {
      "brand": "Coop Bio",
      "labels": [
        "Bio",
        "Fair Trade"
      ],
      "rating": 4.8,
      "weight": "100 g",
      "category": "Alimentation",
      "productId": "3821045",
      "isAvailable": true,
      "isPromotion": true,
      "productName": "Coop Bio Chocolat Noir 70% Équateur",
      "reviewCount": 214,
      "subCategory": "Chocolat & Confiserie",
      "productPrice": "2.50 CHF",
      "promotionPrice": "1.90 CHF",
      "productImageURL": "https://www.coop.ch/etc.clientlibs/coop-core/clientlibs/de/production/img/productManagement/10933-webProductImg-3821045-default-v1-x-small.jpg",
      "productDetailsURL": "https://www.coop.ch/fr/alimentation/chocolat-confiserie/chocolat/coop-bio-chocolat-noir-70-equateur-100g/p/0000000003821045"
    },
    {
      "brand": "Lindt",
      "labels": [],
      "rating": 4.7,
      "weight": "100 g",
      "category": "Alimentation",
      "productId": "5102387",
      "isAvailable": true,
      "isPromotion": false,
      "productName": "Lindt Excellence Chocolat Noir 70%",
      "reviewCount": 392,
      "subCategory": "Chocolat & Confiserie",
      "productPrice": "2.95 CHF",
      "promotionPrice": null,
      "productImageURL": "https://www.coop.ch/etc.clientlibs/coop-core/clientlibs/de/production/img/productManagement/10933-webProductImg-5102387-default-v1-x-small.jpg",
      "productDetailsURL": "https://www.coop.ch/fr/alimentation/chocolat-confiserie/chocolat/lindt-excellence-chocolat-noir-70-100g/p/0000000005102387"
    }
  ],
  "totalPages": 6,
  "currentPage": 1,
  "totalResults": 58
}
```

## Documentation

## Overview
The Coop Search API lets you query the full Coop Switzerland product catalogue in real time. Retrieve product names, prices, ongoing promotions, certification labels (Bio, Fair Trade, IP-SUISSE, Rainforest Alliance), availability status, customer ratings, and direct product URLs: across all three Swiss language storefronts (French, German, Italian).

## Quickstart
```
GET https://api.piloterr.com/v2/coop/search?query=chocolat+noir&language=fr
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword, brand name, or product reference to search |
| `language` | string | no | Storefront language: `fr`, `de`, `it`. Defaults to `fr` |
| `category` | string | no | Category slug to filter results (e.g. `alimentation`, `beaute-sante`) |
| `max_results` | integer | no | Number of results per page (max 100, default 25) |
| `page` | integer | no | Page number for pagination (default 1) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `query` | string | The submitted search term |
| `totalResults` | number | Total matching products across all pages |
| `currentPage` | number | Current page index |
| `totalPages` | number | Total pages available |
| `results[].productId` | string | Unique Coop product identifier |
| `results[].productName` | string | Full product display name |
| `results[].brand` | string | Brand or Coop own-label |
| `results[].productPrice` | string | Regular shelf price (CHF) |
| `results[].promotionPrice` | string | Promotional price if active |
| `results[].isPromotion` | boolean | Whether a promotion is active |
| `results[].labels` | array | Quality certifications (Bio, Fair Trade…) |
| `results[].isAvailable` | boolean | Current stock status |
| `results[].rating` | number | Customer rating (1–5) |
| `results[].productDetailsURL` | string | Direct URL to Coop.ch product page |

## Notes
- All prices are in CHF (Swiss Francs)
- Use `language` to switch between `fr`, `de`, and `it` storefronts
- Promoted products return both `productPrice` (original) and `promotionPrice` (discounted)

## Main use cases
- Monitor competitor pricing on Coop Switzerland to benchmark your retail or wholesale strategy
- Build automated price-tracking dashboards for Swiss grocery products across multiple categories
- Enrich product catalogues with real-time Coop data for retail intelligence and e-commerce comparison tools
- Feed a price-alert system to notify buyers the moment a targeted product goes on promotion at Coop
- Collect structured product data from Coop for training retail-focused machine learning models