# About You API scraper — aboutyou.de fashion shop: keyword search, category listings with brand and sale filters, and full product cards (price, struck price, per-size stock and seller, colour variants, attributes). No account, no browser.

> 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.
> ReefAPI engine `aboutyou` · 3 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/aboutyou/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free except verified SHEIN NOT_FOUND on product/detail and price (4 credits).
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Send the key as `Authorization: Bearer <key>`, or put it in the URL (`?key=<key>`) when the client has no header field, as ChatGPT does.

## Endpoints

### POST https://api.reefapi.com/aboutyou/v1/search — 3 credits
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.

**Parameters:**
- `query` (string, required) — Search words in German or English (brand names work: 'nike air max'). The site sends some words straight to a brand or category page; the answer then says so in `resolved_to` and lists that page.
- `gender` (enum, optional, default "women") — Shop section the search runs in (the site's target group). [one of: women, men, kids]
- `limit` (integer, optional, default 32) — Rows to return, 1-100.
- `cursor` (string, optional) — Continuation token from a previous search answer (`next_cursor`) to get the next rows. Use together with the same query and gender.

**Returns:** results[{position, product_id, title, brand, brand_id, url, price (shelf price, sale included, no coupon), original_price, discount_percent, coupon_price (only with a code), price_without_tax, currency, has_different_prices, sizes_available[], colour_variant_ids[], is_sponsored, is_sold_out, badges[], image}], count, query, gender, resolved_to (brand/category page the site sent the words to, else null), next_cursor, has_more, total_results (only when the site redirects to a listing; semantic search publishes no total)

**Example request body:**
```json
{
  "query": "rotes kleid",
  "gender": "women",
  "limit": 32
}
```

### POST https://api.reefapi.com/aboutyou/v1/category — 3 credits
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).

**Parameters:**
- `category_id` (integer, required) — About You category id: the number at the end of a /c/… URL (20258 = women's jeans, 20207 = women's shoes, 20202 = men).
- `brand` (string, optional) — Brand filter as `<slug>-<brand_id>` (the `filter_value` of a row in `brands`, e.g. levi-s-226). One brand per call.
- `on_sale` (boolean, optional) — true = only reduced items (the site's Sale filter).
- `cursor` (string, optional) — `next_cursor` from a previous category answer: returns the next rows of the same listing with the same filters (the cursor carries them).

**Returns:** results[{position, product_id, title, brand, brand_id, url, price (shelf price, sale included, no coupon), original_price, discount_percent, coupon_price (only with a code), price_without_tax, currency, has_different_prices, sizes_available[], colour_variant_ids[], is_sponsored, is_sold_out, badges[], image}], count, total_results (the source's own count, first page only), next_cursor, has_more, rows_before (continuation pages), category{id, name, url}, applied_filters, brands[{brand_id, name, slug, product_count, filter_value}], colours[{colour_id, name, product_count}], price_range{min, max, currency}

**Example request body:**
```json
{
  "category_id": 20258
}
```

### POST https://api.reefapi.com/aboutyou/v1/product — 3 credits
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.

**Parameters:**
- `product_id` (integer, required) — About You product id (the number at the end of a /p/… URL, or product_id from search / category rows).

**Returns:** product{product_id, title, brand, brand_id, brand_url, url, master_key, colour, colour_ids[], price, original_price, discount_percent, coupon_price, price_without_tax, currency, has_different_prices, lowest_prior_price_hint, available, stock_quantity, sizes[{size_id, size, vendor_size, article_number, stock_quantity, available, price, original_price, low_stock_hint, seller, seller_text}], sellers[], sold_by_about_you, is_new, is_premium, is_sponsored, is_second_hand, is_exclusive, attributes[{group, values[]}], colour_variants[{product_id, colour, url, is_sold_out}], breadcrumbs[{category_id, name, url}], images[]}

**Example request body:**
```json
{
  "product_id": 32191359
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=aboutyou
- Human docs page: https://reefapi.com/docs/aboutyou
- Overview page: https://reefapi.com/aboutyou-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt