--- title: "About You API: Search | Perceptlayer" description: "Search from About You as JSON. 1–3 credits per successful call." url: https://perceptlayer.com/apis/about-you/search --- [APIs](https://perceptlayer.com/apis) / [About You](https://perceptlayer.com/apis/about-you) / Search # About You: Search Search from About You as JSON. 1–3 credits per successful call. GET `/v1/about-you/search` ## Parameters Send parameters in the query string. | Parameter | Type | Required | Allowed values | | --- | --- | --- | --- | | `query` | string | Optional | Up to 100 characters | | `category` | integer | Optional | Any | | `brand` | string | Optional | Up to 600 characters | | `color` | string | Optional | Up to 600 characters | | `size` | string | Optional | Up to 300 characters | | `size_system` | string | Optional | Any | | `min_price` | number | Optional | Any | | `max_price` | number | Optional | Any | | `sale_only` | string | Optional | true, false, 1, 0 | | `sort` | string | Optional | top\_seller, highest\_reduction, price\_desc, price\_asc, newest | | `page` | integer | Optional | Any | | `limit` | integer | Optional | Any | | `include_facets` | string | Optional | true, false, 1, 0 | | `resolve_names` | string | Optional | true, false, 1, 0 | | `country` | string | Optional | de, ch, at, nl, be, pl, cz, sk, ro, hu, fr, lu | | `language` | string | Optional | de, fr, nl, pl, cs, sk, ro, hu | ## Example request 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. [Run this endpoint in the playground](https://perceptlayer.com/apis/about-you?try=search#playground) with your own parameters. 1–3 credits per successful call (1 credit, plus 1 with resolve\_names and 1 with include\_facets); failed calls are free.