# About You Search

## Overview

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

## Description

Search an About You shop with a keyword or a search URL. Pick the country with region, or let a full link choose the shop. Cards include brand, price, and the product link.

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

## Example Response

### Suede bloom, France

```json
{
  "results": [
    {
      "id": 24283626,
      "url": "https://www.aboutyou.fr/p/puma/baskets-basses-suede-xl-24283626",
      "name": "Baskets basses 'Suede XL'",
      "brand": "PUMA",
      "image": "https://cdn.aboutstatic.com/file/images/970952623a9504597b852a2f439e7c35.png?bg=F4F4F5&quality=75&trim=1",
      "price": 99.95,
      "region": "fr",
      "currency": "EUR",
      "price_display": "99,95 €"
    }
  ],
  "pagination": {
    "next": null,
    "page": 1,
    "per_page": 31,
    "total_pages": null,
    "total_results": null
  }
}
```

## Documentation

## Overview
Search an About You shop. Pass a keyword such as `suede bloom`, or a search, category, or brand URL. Each card has a brand, name, price, currency, and product link.

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

`price` is a number. `price_display` is that amount as the shop writes it (`99,95 €`, `CHF 77.90`, `432,90 zł`, `1 779 Kč`, `35.990 Ft`, `819,00 kr`). Keyword search does not expose a total, so `total_results`, `total_pages`, and `next` are null. Only page 1 exists.

## Quickstart
```
GET https://api.piloterr.com/v2/aboutyou/search?query=suede%20bloom
GET https://api.piloterr.com/v2/aboutyou/search?query=suede%20bloom&region=de
GET https://api.piloterr.com/v2/aboutyou/search?query=https://www.aboutyou.fr/search?term=robe
```

## 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 card from www.aboutyou.fr on 2026-10-29: price 99.95, price_display `99,95 €`, currency EUR, region fr, name Baskets basses 'Suede XL', brand PUMA.

## Main use cases
- Track sneaker and apparel prices in France, Germany, and Switzerland
- Open one country shop, such as PUMA on aboutyou.de
- Copy a product URL into Product

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