# Mr.Bricolage Product Price

## Overview

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

## Description

Lightweight Mr.Bricolage endpoint that returns the live price, availability, stock and delivery summary of a product scoped to a specific store.

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

## Example Response

### Product 7117 in store S727 (Matignon)

```json
{
  "price": 12.95,
  "store": {
    "id": "S727",
    "slug": "Matignon"
  },
  "currency": "EUR",
  "saleable": true,
  "product_id": "7117",
  "availability": "InStock",
  "delivery_text": "Retrait en magasin en 2 semaines"
}
```

## Documentation

## Overview
The Mr.Bricolage Product Price endpoint hits the internal `getproduct` REST API to return only the pricing-related data of a product: price, currency, eco-participation, availability, stock, saleable flag and delivery summary. It is much faster and cheaper than the full [Mr.Bricolage Product](https://app.piloterr.com/library/mrbricolage-product) endpoint because it does not parse the HTML page. Use the Mr.Bricolage Product endpoint to get the static catalog data (title, brand, EAN, category, characteristics, images, reviews) and pair it with this endpoint for live pricing.

## Quickstart
```
GET https://api.piloterr.com/v2/mrbricolage/product/price?store_id=S727&product_id=7117
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `store_id` | string | yes | Mr.Bricolage store identifier (e.g. `S727`). Use the Mr.Bricolage Stores Finder endpoint to find one |
| `product_id` | string | yes | Internal Mr.Bricolage product ID (Magento entity id). Use the Mr.Bricolage Product endpoint to resolve a `product_id` from a product URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `product_id` | string | Internal Mr.Bricolage product ID (echo of the input) |
| `price` | number | Product price for the requested store |
| `currency` | string | ISO currency code (e.g. `EUR`) |
| `eco_participation` | number | Eco-participation amount included in the displayed price |
| `availability` | string | Availability flag returned by Mr.Bricolage (e.g. `InStock`) |
| `saleable` | boolean | Whether the product can currently be ordered |
| `delivery_text` | string | Plain-text delivery summary returned by Mr.Bricolage |
| `delivery` | array | Detailed delivery options with `method`, `type`, `shop` and `price_label` (when available) |
| `store` | object | `id` and `slug` of the requested store |

## Notes
- This endpoint only returns live pricing data. Static product details (title, brand, EAN, category, characteristics, images, reviews) are returned by the [Mr.Bricolage Product](https://app.piloterr.com/library/mrbricolage-product) endpoint
- A `store_id` is required because Mr.Bricolage hides price, stock and delivery options when no store is selected
- Prices, stock and delivery options depend on the requested store; the same product can return different values across stores
- Empty fields are omitted from the response

## Main use cases
- Real-time price monitoring across many Mr.Bricolage stores without paying for the full product payload
- Repricing pipelines that already know the `product_id` and only need the latest price/availability
- Cart-level checks before placing an order
- Compare delivery options between stores for the same product