--- title: "About You API: JSON data, 2 endpoints, 1 credit per call" description: "About You API for fashion search by category, brand, size, price and sale, plus product details by country, as JSON. From 1 credit per call." url: https://perceptlayer.com/apis/about-you --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / About You 1 credit per call 2 endpoints 14 datapoints # About You API About You API for fashion search by category, brand, size, price and sale, plus product details by country, as JSON. From 1 credit per call. [Get a free API key](https://perceptlayer.com/signup) Run it below About You GET /v1/about-you/search?category=20202&sale\_only=true&sort=highest\_reduction&country=de ``` { "success": true, "data": { "resolved_as": "category", "category_id": 20202, "country": "de", "language": "de", "page": 1, "limit": 30, "sort": "highest_reduction", "count": 28, "has_more": true, "items": [ { "id": 32634873, "name": "Umhängetasche 'Borsa a Tracolla Donna Gianmarco Venturi Ecopelle Motif Print 13x18 cm'‌‌‌‌‌‌‌", "brand": { "id": 206865, "name": "GianMarco Venturi" }, "url": "https://www.aboutyou.de/p/gianmarco-venturi/umhangetasche-borsa-a-tracolla-donna-gianmarco-venturi-ecopelle-motif-print-13x18-cm-32634873", "image": "https://cdn.aboutstatic.com/file/images/8114f85aaaf900bc1014ef0b331646c6.jpg?brightness=0.96&trim=1", "images": [ "https://cdn.aboutstatic.com/file/images/8114f85aaaf900bc1014ef0b331646c6.jpg?brightness=0.96&trim=1", "https://cdn.aboutstatic.com/file/images/96d213fa4df1595e5b73508f93b74c7b.jpg", "https://cdn.aboutstatic.com/file/images/8ada37cdced3517ebb5e505d99cdbdaf.jpg" ], "price": { "currency": "EUR", "current": 38.99, "original": 292.5, "net": 32.76, "discount_amount": 253.51, "discount_percent": 86 }, "on_sale": true, "price_reference": { "label": "Letzter niedrigster Preis", "amount": 39 }, "coupon_label": "-86%", "badges": [ "-86%", "Neu" ], "sizes": [ "One Size" ], "color_variants": [ { "product_id": 32634873, "hex": "#ffffff" }, { "product_id": 32633267, "hex": "#000000" }, { "product_id": 32634825, "hex": "#bdb76b" } ], "sponsored": false }, { "id": 32634825, "name": "Umhängetasche 'Borsa a Tracolla Donna Gianmarco Venturi Ecopelle Motif Print 13x18 cm'‌‌‌‌‌‌‌", "brand": { "id": 206865, "name": "GianMarco Venturi" }, "url": "https://www.aboutyou.de/p/gianmarco-venturi/umhangetasche-borsa-a-tracolla-donna-gianmarco-venturi-ecopelle-motif-print-13x18-cm-32634825", "image": "https://cdn.aboutstatic.com/file/images/c6d0148963307828ae9541b1db1df1e7.jpeg?brightness=0.96&trim=1", "images": [ "https://cdn.aboutstatic.com/file/images/c6d0148963307828ae9541b1db1df1e7.jpeg?brightness=0.96&trim=1", "https://cdn.aboutstatic.com/file/images/f1bfa4a71f6d30ad887387502799bde8.jpg", "https://cdn.aboutstatic.com/file/images/024576b723677e3b1c55deb660a87ae7.jpg" ], "price": { "currency": "EUR", "current": 38.99, "original": 292.5, "net": 32.76, "discount_amount": 253.51, "discount_percent": 86 }, "on_sale": true, "price_reference": { "label": "Letzter niedrigster Preis", "amount": 39 }, "coupon_label": "-86%", "badges": [ "-86%", "Neu" ], "sizes": [ "One Size" ], "color_variants": [ { "product_id": 32634825, "hex": "#bdb76b" }, { "product_id": 32633267, "hex": "#000000" }, { "product_id": 32634873, "hex": "#ffffff" } ], "sponsored": false }, { "id": 32633267, "name": "Umhängetasche 'Borsa a Tracolla Donna Gianmarco Venturi Ecopelle Motif Print 13x18 cm'‌‌‌‌‌‌‌", "brand": { "id": 206865, "name": "GianMarco Venturi" }, "url": "https://www.aboutyou.de/p/gianmarco-venturi/umhangetasche-borsa-a-tracolla-donna-gianmarco-venturi-ecopelle-motif-print-13x18-cm-32633267", "image": "https://cdn.aboutstatic.com/file/images/32130af0f3be33c14fc1900fddca8891.jpg?brightness=0.96&trim=1", "images": [ "https://cdn.aboutstatic.com/file/images/32130af0f3be33c14fc1900fddca8891.jpg?brightness=0.96&trim=1", "https://cdn.aboutstatic.com/file/images/9096091808f43008aa06129c446f9dd1.jpg", "https://cdn.aboutstatic.com/file/images/230cd9f9de1855ba39715fafad7bb2cc.jpg" ], "price": { "currency": "EUR", "current": 38.99, "original": 292.5, "net": 32.76, "discount_amount": 253.51, "discount_percent": 86 }, "on_sale": true, "price_reference": { "label": "Letzter niedrigster Preis", "amount": 39 }, "coupon_label": "-86%", "badges": [ "-86%", "Neu" ], "sizes": [ "One Size" ], "color_variants": [ { "product_id": 32633267, "hex": "#000000" }, { "product_id": 32634825, "hex": "#bdb76b" }, { "product_id": 32634873, "hex": "#ffffff" } ], "sponsored": false } ] }, "meta": { "endpoint_family": "search", "request_id": "req_4a065ab40e6b4806ba5483bc535adaca", "credits_charged": 1, "credits_remaining": 1995 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id integer | name string | brand object | url url | image url | images string\[\] | price object | on\_sale boolean | price\_reference object | coupon\_label string | badges string\[\] | sizes string\[\] | color\_variants object\[\] | sponsored boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 32634873 | Umhängetasche 'Borsa a Tracolla Donna Gianmarco Venturi Ecopelle Motif Print 13x18 cm'‌‌‌‌‌‌‌ | {2 fields} | https://www.aboutyou.de/p/gianmarco-venturi/umhangetasche-borsa-a-tracolla-donna-gianmarco-venturi-ecopelle-motif-print-13x18-cm-32634873 | https://cdn.aboutstatic.com/file/images/8114f85aaaf900bc1014ef0b331646c6.jpg?brightness=0.96&trim=1 | \[3 items\] | {6 fields} | true | {2 fields} | \-86% | \[2 items\] | \[1 item\] | \[3 items\] | false | | 2 | 32634825 | Umhängetasche 'Borsa a Tracolla Donna Gianmarco Venturi Ecopelle Motif Print 13x18 cm'‌‌‌‌‌‌‌ | {2 fields} | https://www.aboutyou.de/p/gianmarco-venturi/umhangetasche-borsa-a-tracolla-donna-gianmarco-venturi-ecopelle-motif-print-13x18-cm-32634825 | https://cdn.aboutstatic.com/file/images/c6d0148963307828ae9541b1db1df1e7.jpeg?brightness=0.96&trim=1 | \[3 items\] | {6 fields} | true | {2 fields} | \-86% | \[2 items\] | \[1 item\] | \[3 items\] | false | | 3 | 32633267 | Umhängetasche 'Borsa a Tracolla Donna Gianmarco Venturi Ecopelle Motif Print 13x18 cm'‌‌‌‌‌‌‌ | {2 fields} | https://www.aboutyou.de/p/gianmarco-venturi/umhangetasche-borsa-a-tracolla-donna-gianmarco-venturi-ecopelle-motif-print-13x18-cm-32633267 | https://cdn.aboutstatic.com/file/images/32130af0f3be33c14fc1900fddca8891.jpg?brightness=0.96&trim=1 | \[3 items\] | {6 fields} | true | {2 fields} | \-86% | \[2 items\] | \[1 item\] | \[3 items\] | false | Recorded from our API · 3 items shown · 14 datapoints per item GET /v1/about-you/search?category=20202&sale\_only=true&sort=highest\_reduction&country=de 14 datapoints ### Identity - id integer - name string - brand object ### Contact - url url ### Reputation - image url - images string\[\] - badges string\[\] ### Price - price object - price\_reference object ### Other - on\_sale boolean - coupon\_label string - sizes string\[\] - color\_variants object\[\] - sponsored boolean Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/about-you/search?category=20202&sale_only=true&sort=highest_reduction&country=de" \ -H "X-API-Key: $API_KEY" ``` About You · 2 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/about-you/product`](https://perceptlayer.com/apis/about-you/product) | none +4 optional | 1 credit | | [GET `/v1/about-you/search`](https://perceptlayer.com/apis/about-you/search) | none +16 optional | 1–3 credits | Overview ## About the About You API ## What you can get The About You API returns About You fashion data as JSON through 2 endpoints. Both take a `country` (de, ch, at, nl, be, pl, cz, sk, ro, hu, fr or lu) and a `language` (de, fr, nl, pl, cs, sk, ro or hu). - **Search:** `search` takes a `query` or a `category`, with `brand`, `color`, `size`, `size_system`, `min_price`, `max_price`, `sale_only`, `sort` (top\_seller, highest\_reduction, price\_desc, price\_asc or newest), `page` and `limit`. It also takes `include_facets` and `resolve_names`, each of which adds 1 credit. - **Products:** `product` takes a `product_id` or a product `url`. The recorded search for category 20202 in de, with `sale_only` and `sort=highest_reduction`, returns `resolved_as`, `category_id`, `page`, `limit`, `count`, `has_more` and `items`. Each item has `id`, `name`, `brand`, `url`, `images`, `price` (with `current`, `original`, `discount_amount` and `discount_percent`), `on_sale`, `price_reference`, `badges`, `sizes`, `color_variants` and `sponsored`. ## How a call works Search a category: `GET /v1/about-you/search?category=20202&sale_only=true&sort=highest_reduction&country=de` with your key in the `X-API-Key` header. Each item carries an `id`, and each colour in `color_variants` a `product_id`; `product` takes a `product_id`. Check `has_more` before asking for the next `page`. A search costs 1 credit, plus 1 with `resolve_names` and 1 with `include_facets`, so at most 3; every other successful call costs 1 credit, and failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) [Depop](https://perceptlayer.com/apis/depop) Use cases ### Track sale prices and discounts for a category or brand `Use the About You API to track sale prices and discounts for a category or brand` ### Rank sale items by reduction with \`sort=highest\_reduction\` `` Use the About You API to rank sale items by reduction with `sort=highest_reduction` `` ### Compare prices for the same product across About You countries `Use the About You API to compare prices for the same product across About You countries` ### Watch new arrivals in a category with \`sort=newest\` `` Use the About You API to watch new arrivals in a category with `sort=newest` `` FAQ ## Questions **How much does the About You API cost?** Each successful call costs one credit. A search costs one more with \`resolve\_names\` and one more with \`include\_facets\`, so three at most. New accounts get free credits to start, and credit packs bring the price down as you scale. **Which countries can I query?** \`country\` takes de, ch, at, nl, be, pl, cz, sk, ro, hu, fr or lu, and \`language\` takes de, fr, nl, pl, cs, sk, ro or hu. **Can I search only items on sale?** Yes. Pass \`sale\_only=true\` to \`search\`, and \`sort=highest\_reduction\` to order results by discount. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build an About You scraper instead?** You can, but an About You scraper is code you maintain: page changes break it, requests get blocked, and About You's terms govern how you collect data. The About You API gives you 2 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the About You API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)