Piloterr

Brico Dépôt Search

GET
/v2/bricodepot/search

Search Brico Dépôt with a /produits/ listing URL, not a keyword box. Page 2 is the same path with /2 at the end.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Brico Dépôt listing URL under /produits/.

Example:

https://www.bricodepot.fr/produits/outillage/outillage-electroportatif-a-main-et-accessoire/perceuse-visseuse-et-outillage-de-percage/perceuse-visseuse-et-perceuse-a-percussion-sans-fil

A product URL or a bare keyword returns 400. page starts at 1. Page 2 uses the /2 path suffix.

page?number

Page from 1. Page 2 is the /2 path suffix.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/bricodepot/search?query=string'
Example Response
{  "results": [    {      "sku": "5063022810069",      "url": "https://www.bricodepot.fr/p/5063022810069/perceuse-visseuse-sans-fil-18-v-50-nm-2-vitesses",      "name": "Perceuse visseuse sans fil 18 V 50 Nm 2 vitesses",      "badge": "Nouveau",      "image": "https://media.bricodepot.fr/is/image/KingfisherDigital/5063022810069_01i?wid=300&hei=300",      "price": 17.9,      "currency": "EUR",      "price_unit": "TTC/pièce",      "price_display": "17,90 €"    }  ],  "pagination": {    "next": "https://www.bricodepot.fr/produits/outillage/outillage-electroportatif-a-main-et-accessoire/perceuse-visseuse-et-outillage-de-percage/perceuse-visseuse-et-perceuse-a-percussion-sans-fil/2",    "page": 1,    "per_page": 36,    "total_pages": 2,    "total_results": 63  }}