Bricorama Search
GET
Search Bricorama by keyword or search URL and page the home-improvement grid.
Credit cost: 1 credit per call
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringKeyword, or a Bricorama /search URL.
Examples:
perceusehttps://www.bricorama.fr/search?q=perceuseA product URL (/p/...) returns 400. page starts at 1 and is sent as ?page=.
page?numberPage from 1. Sent as ?page= on the listing.
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}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/bricorama/search?query=string'Example Response
{ "results": [ { "ean": "3999991691267", "url": "https://www.bricorama.fr/p/perceuse-visseuse-sans-fil-18v/3999991691267", "name": "Perceuse visseuse sans fil 18V", "brand": "GO/ON", "image": "https://assets-big.cdn-mousquetaires.com/medias/domain11440/media2624/393739-2ftpvnauip-large.jpg", "price": 27.9, "seller": null, "currency": "EUR", "delivery": "Retrait en 2h en magasin", "position": 1, "was_price": null, "availability": "En stock selon magasin", "price_display": "27,90 €", "discount_display": null, "was_price_display": null } ], "pagination": { "next": "https://www.bricorama.fr/search?q=perceuse&page=2", "page": 1, "per_page": 48, "total_pages": null, "total_results": null }}