About You API & Scraper
The About You API turns aboutyou.de, one of Europe's largest fashion shops, into JSON in three actions.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
search takes words in German or English and a shop section (women, men, kids) and returns up to 100 product rows a call with a cursor for the next rows; when the shop sends the words straight to a brand or category page, the answer says which page and lists it. category lists a category about 30 products a page, with next_cursor for the following pages, the brand and sale filters and the category's own facets: brands with product counts, colours with counts and the price range. product returns one card in full: brand, colour, the shelf price and struck price, every size with its stock quantity, article number and seller, the colour variants, attributes and the breadcrumb path. Every row carries product_id, which opens the same product in product. One ReefAPI key, the standard { ok, data, meta, error } envelope, no About You account.
What one About You product returns
Real results read on 2026-10-15. Eight ids taken from search and category rows opened the same product card with the same price and struck price (8 of 8).
| product | what the shop shows | price / original_price | other fields |
|---|---|---|---|
| PUMA Sneaker 'Bloom', product card | 69,90 € · 89,90 € (SALE) | 69.90 / 89.90 | 12 sizes, stock 118 in total, sold by ABOUT YOU |
| ONLY Kleid, search row and card | 15,90 € · 39,90 € (−60%) | 15.90 / 39.90 | discount_percent 60, 12 colour variants |
| Lee Jeans 'STELLA', listing row | 80,91 € with a −10% COUPON badge | 89.90 / null | coupon_price 80.91, kept apart from price |
price is what the shop charges without a code, sale reductions included. A coupon figure shown on a tile is returned as coupon_price and never as price (72 of 366 rows in our sample showed one). Prices are in euros from the German shop.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/aboutyou/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "rotes kleid",
"gender": "women",
"limit": 32
}
}{
"ok": true,
"meta": {
"api": "aboutyou",
"endpoint": "search",
"mode": "live",
"latency_ms": 3641.5,
"record_count": 32,
"bytes": 207422,
"cache_hit": false,
"upstream_requests": 2,
"exits_tried": 2,
"charged_credits": 3,
"version": "0.1.0",
"request_id": "8cdc64c0c5da4a55",
"queue_ms": 2,
"fetched_at": "2026-10-15T17:02:53.904Z"
},
"data": {
"query": "rotes kleid",
"gender": "women",
"results": [
{
"position": 1,
"product_id": 27898169,
"title": "Kleid",
"brand": "Trendyol",
"brand_id": 73754,
"url": "https://www.aboutyou.de/p/trendyol/kleid-27898169",
"price": 52.9,
"original_price": null,
"discount_percent": null,
"coupon_price": null,
"price_without_tax": 44.45,
"currency": "EUR",
"has_different_prices": false,
"sizes_available": [
"34",
"36",
"38"
],
"colour_variant_ids": [
27864877,
32113827
],
"is_sponsored": false,
"is_sold_out": false,
"badges": [],
"image": "https://cdn.aboutstatic.com/file/images/031f4b3e0e00c2fbadbe0b86516f8301.png?bg=F4F4F5&quality=75&trim=1"
},
{
"position": 2,
"product_id": 24932974,
"title": "Kleid",
"brand": "ONLY",
"brand_id": 641,
"url": "https://www.aboutyou.de/p/only/kleid-24932974",
"price": 15.9,
"original_price": 39.9,
"discount_percent": 60,
"coupon_price": null,
"price_without_tax": 13.36,
"currency": "EUR",
"has_different_prices": false,
"sizes_available": [
"32",
"34",
"36"
],
"colour_variant_ids": [
4755504,
4755520,
9531844
],
"is_sponsored": false,
"is_sold_out": false,
"badges": [
"sale"
],
"image": "https://cdn.aboutstatic.com/file/images/74a1937f8d322218cb3915630a55e24a.jpg?brightness=0.96&quality=75&trim=1"
},
{
"position": 3,
"product_id": 32264173,
"title": "Strickkleid",
"brand": "Yesfashion",
"brand_id": 179940,
"url": "https://www.aboutyou.de/p/yesfashion/strickkleid-32264173",
"price": 40.99,
"original_price": 56.99,
"discount_percent": 28,
"coupon_price": null,
"price_without_tax": 34.45,
"currency": "EUR",
"has_different_prices": false,
"sizes_available": [
"S",
"M",
"L"
],
"colour_variant_ids": [
32264226,
32264250
],
"is_sponsored": false,
"is_sold_out": false,
"badges": [
"sale"
],
"image": "https://cdn.aboutstatic.com/file/images/ae089bc6ea1e52b44e4875821002e031.jpeg?brightness=0.96&quality=75&trim=1"
}
],
"count": 32,
"resolved_to": null,
"total_results": null,
"next_cursor": "s.32.0.T3Y0Q0x3TUJBUkZUWldGeVkyaFRkSEpsWVcxVWIydGxiZ0grQWpBQUFRSUJDRTVsZUhSUVlXZGxBUVFBQVFkUVpYSlFZV2RsQVFRQUFBQUkvZ0l3QVFRQlFBQT0",
"has_more": true
}
}What the About You API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Keyword search over the aboutyou.de catalogue in one shop section (women / men / kids), up to 100 rows a call (when the site sends the words to a brand or category page, that page's ~30 rows), with next_cursor for the next rows. | Pricing teams call search to get keyword search over the aboutyou.de catalogue in one shop section (women / men / kids), up to…. | query, gender, limit, cursor |
| category | One About You category, about 30 product tiles a page, with the brand and sale filters, plus the category's own facets: brands with product counts, colours with counts and the price range. Pass next_cursor back as cursor for the next rows (filters are carried by the cursor). | Marketplace operators call category to get one About You category, about 30 product tiles a page, with the brand and sale filters, plus…. | category_id, brand, on_sale, cursor |
| product | One full About You product card: title, brand, colour, price and struck price, every size with its stock quantity, article number and seller, colour variants, attributes, breadcrumbs and images. | Catalog enrichment teams call product to get one full About You product card. | product_id |
Call search from your stack
curl -X POST https://api.reefapi.com/aboutyou/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"rotes kleid","gender":"women","limit":32}'import requests
r = requests.post(
"https://api.reefapi.com/aboutyou/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "rotes kleid",
"gender": "women",
"limit": 32
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/aboutyou/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "rotes kleid",
"gender": "women",
"limit": 32
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.aboutyou.search with {"query":"rotes kleid","gender":"women","limit":32}.Who uses this API and why
- Track fashion prices in Germany: product for your items, with the shelf price, the struck price and any coupon kept apart.
- Size-level availability: every size with its stock quantity for sell-through and restock tracking.
- Brand assortment: category with a brand filter, plus the brand facet with product counts per category.
- Sale monitoring: category with on_sale for reduced items and their discount.
- Compare with Zalando: the same keyword on both shops, rows with matching field names.
Questions developers ask before integrating
Which prices does it return?
price (the shelf price, sale reductions included), original_price (the struck price when the item is reduced) with the computed discount_percent, coupon_price when the shop advertises a coupon on the item, and price_without_tax. In our 2026-10-15 sample 138 of 366 rows were reduced and 72 carried a coupon price.
Does it give stock per size?
Yes, on product: every size with its stock quantity, article number, price and the seller that ships it. Listing rows carry the sizes still available but no quantities.
How many results can I get?
Both search and category return next_cursor; pass it back as cursor for the next rows, with the same filters. search returns up to 100 rows a call (about 30 when the shop sends the words to a brand or category page), category about 30 a page with the shop's own total. In our test three further pages of women's jeans shared no product with the pages before, and the brand filter held on every row.
Which filters are there?
On category: brand (as slug-id, taken from the brands facet of the same answer, e.g. levi-s-226) and on_sale. In our test women's jeans went from 19 910 products to 673 with the Levi's filter and 10 816 with on_sale. On search: the shop section (women, men, kids). Sorting is not offered: the shop ignored the sort we tested.
Does it cover other About You countries?
This version reads the German shop (aboutyou.de) in euros. Other storefronts were not measured and are not offered.
Who is the seller?
Each size names its seller as the shop prints it (for example ABOUT YOU), and sold_by_about_you says whether every size is sold by About You itself.
How fast is it?
In our 2026-10-15 run every positive call succeeded (17 of 17). Median times were about 6.4 seconds for search, 3.1 seconds for category and 3.4 seconds for product, with the slowest calls between 11 and 13 seconds.
What is the About You API?
About You API is a ReefAPI endpoint group for germany's about you fashion shop as json: keyword search, category listings with brand and sale filters, and full product cards with the shelf price, struck price, every size with its stock and seller. It returns live JSON through POST requests under /aboutyou/v1.
Is the About You API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. About You calls use the same shared credit balance as every other ReefAPI engine.
Do I need an About You login or account?
No login to About You is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the About You data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the About You API use?
About You actions currently cost 3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call About You from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call aboutyou actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the About You API an About You scraper?
It is the managed alternative to a DIY About You scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same germany's about you fashion shop as json: keyword search, category listings with brand and sale filters, and full product cards with the shelf price, struck price, every size with its stock and seller back as clean JSON.