# About You Product

## Overview

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

## Description

Read one About You product from a product URL or a keyword. A keyword opens the first search hit. Set region when the query does not already name the shop.

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

## Example Response

### PUMA Suede Bloom, France

```json
{
  "id": 32191359,
  "url": "https://www.aboutyou.fr/p/puma/baskets-basses-suede-bloom-32191359",
  "name": "Baskets basses 'Suede Bloom'",
  "brand": "PUMA",
  "color": "rose",
  "image": "https://cdn.aboutstatic.com/file/images/f69d3161a57ca8a8aff626a5acc399bf.jpg?brightness=0.96&quality=75&trim=1",
  "price": 69.9,
  "region": "fr",
  "currency": "EUR",
  "in_stock": true,
  "price_display": "69,90 €",
  "article_number": "PUMliff008000002",
  "original_price": 89.9,
  "original_price_display": "89,90 €"
}
```

## Documentation

## Overview
Read one About You product. Pass a product URL, or a keyword. A keyword opens the first search result. The response is one flat object.

The default shop is France (`fr`). A full URL selects the shop. If `region` and the URL disagree, the call returns 400.

`price` is the current amount. `original_price` is the previous amount when the page shows one. `price_display` is the amount as that shop writes it.

## Quickstart
```
GET https://api.piloterr.com/v2/aboutyou/product?query=https://www.aboutyou.fr/p/puma/baskets-basses-suede-bloom-32191359
GET https://api.piloterr.com/v2/aboutyou/product?query=suede%20bloom&region=fr
GET https://api.piloterr.com/v2/aboutyou/product?query=https://www.aboutyou.de/p/puma/sneaker-suede-bloom-32191359
```

## Shops
| Region | Host | Language | Currency |
|---|---|---|---|
| `fr` | www.aboutyou.fr | fr | EUR |
| `de` | www.aboutyou.de | de | EUR |
| `de-en` | en.aboutyou.de | en | EUR |
| `at` | www.aboutyou.at | de | EUR |
| `at-en` | en.aboutyou.at | en | EUR |
| `ch` | www.aboutyou.ch | de | CHF |
| `ch-en` | en.aboutyou.ch | en | CHF |
| `ch-fr` | fr.aboutyou.ch | fr | CHF |
| `ch-it` | it.aboutyou.ch | it | CHF |
| `nl` | www.aboutyou.nl | nl | EUR |
| `nl-en` | en.aboutyou.nl | en | EUR |
| `be` | www.aboutyou.be | nl | EUR |
| `be-fr` | fr.aboutyou.be | fr | EUR |
| `lu` | www.aboutyou.lu | fr | EUR |
| `pl` | www.aboutyou.pl | pl | PLN |
| `cz` | www.aboutyou.cz | cs | CZK |
| `sk` | www.aboutyou.sk | sk | EUR |
| `hu` | www.aboutyou.hu | hu | HUF |
| `ro` | www.aboutyou.ro | ro | RON |
| `si` | www.aboutyou.si | sl | EUR |
| `lt` | www.aboutyou.lt | lt | EUR |
| `lv` | www.aboutyou.lv | lv | EUR |
| `lv-ru` | ru.aboutyou.lv | ru | EUR |
| `ee` | www.aboutyou.ee | et | EUR |
| `ee-ru` | ru.aboutyou.ee | ru | EUR |
| `hr` | www.aboutyou.hr | hr | EUR |
| `bg` | www.aboutyou.bg | bg | EUR |
| `se` | www.aboutyou.se | sv | SEK |
| `dk` | www.aboutyou.dk | da | DKK |
| `fi` | www.aboutyou.fi | fi | EUR |
| `it` | www.aboutyou.it | it | EUR |
| `es` | www.aboutyou.es | es | EUR |
| `pt` | www.aboutyou.pt | pt | EUR |
| `gr` | www.aboutyou.gr | el | EUR |
| `cy` | www.aboutyou.com.cy | el | EUR |

`www.aboutyou.com` and `es.aboutyou.com` redirect to a local shop and are not separate regions.

## Example
Real sheet from www.aboutyou.fr on 2026-10-29: price 69.9, price_display `69,90 €`, original_price 89.9, original_price_display `89,90 €`, currency EUR, region fr, name Baskets basses 'Suede Bloom', brand PUMA.

## Main use cases
- Open the PUMA sneaker a search card pointed to
- Compare the euro price in France with the franc price in Switzerland
- Keep the sale price next to the previous price when the page shows one

## Error codes
| Code | Meaning |
|---|---|
| 400 | Empty query, bad domain, or conflicting region and URL |
| 401 | Missing API key |
| 404 | The page had no product |
| 500 | The page could not be rendered |