Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / About You

1 credit per call2 endpoints14 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 keyRun 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 OKJSONX-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.

#idintegernamestringbrandobjecturlurlimageurlimagesstring[]priceobjecton_salebooleanprice_referenceobjectcoupon_labelstringbadgesstring[]sizesstring[]color_variantsobject[]sponsoredboolean
132634873Umhä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-32634873https://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
232634825Umhä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-32634825https://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
332633267Umhä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-32633267https://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 itemGET /v1/about-you/search?category=20202&sale_only=true&sort=highest_reduction&country=de

14 datapoints

Identity

  • idinteger
  • namestring
  • brandobject

Contact

  • urlurl

Reputation

  • imageurl
  • imagesstring[]
  • badgesstring[]

Price

  • priceobject
  • price_referenceobject

Other

  • on_saleboolean
  • coupon_labelstring
  • sizesstring[]
  • color_variantsobject[]
  • sponsoredboolean

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/about-you/product
none+4 optional
1 credit
GET/v1/about-you/search
none+16 optional
1–3 credits

Overview

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.

MarketplacesJSONRESTMCP

More marketplaces APIs

adidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBADepop

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 keyRead the docs