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 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.
Run this endpoint in the 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.