About You Search
Search an About You shop with a keyword or a search URL. Pick the country with region, or let a full link choose the shop. Cards include brand, price, and the product link.
Credit cost: 2 credits per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringKeyword or About You search, category, or brand URL.
region?stringShop code. Default is fr. A full link in query picks the shop, and a conflicting region returns 400.
Examples:
frdech-frThe full list is the Shops table in the readme.
page?numberOnly page 1 is available.
return_page_source?booleanReturn the rendered HTML instead of JSON.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/aboutyou/search?query=string'{ "results": [ { "id": 24283626, "url": "https://www.aboutyou.fr/p/puma/baskets-basses-suede-xl-24283626", "name": "Baskets basses 'Suede XL'", "brand": "PUMA", "image": "https://cdn.aboutstatic.com/file/images/970952623a9504597b852a2f439e7c35.png?bg=F4F4F5&quality=75&trim=1", "price": 99.95, "region": "fr", "currency": "EUR", "price_display": "99,95 €" } ], "pagination": { "next": null, "page": 1, "per_page": 31, "total_pages": null, "total_results": null }}