Piloterr

Castorama Search

GET
/v2/castorama/search

Search Castorama by keyword or search URL and page the DIY listings. Cards include title, price, and product link.

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

Keyword, or a Castorama listing URL (/search or a .cat category).

Examples:

joint-silicone
https://www.castorama.fr/search?term=joint-silicone
https://www.castorama.fr/outillage/outillage-electroportatif/perceuse-visseuse-perceuse-a-percussion-et-tournevis-sans-fil/cat_id_3796.cat

A product URL (_CAFR.prd) returns 400. page starts at 1 and is sent as ?page=.

page?number

Page from 1. Sent as ?page= on the listing.

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/castorama/search?query=string'
Example Response
{  "results": [    {      "ean": "5410091628840",      "url": "https://www.castorama.fr/mastic-bain-et-cuisine-rubson-blanc-280ml/5410091628840_CAFR.prd",      "name": "Mastic bain et cuisine Rubson blanc 280ml",      "image": "https://media.castorama.fr/is/image/Castorama/mastic-bain-et-cuisine-rubson-blanc-280ml~5410091628840_30c_FR_CF",      "price": 10.9,      "rating": 4.5,      "currency": "EUR",      "position": 1,      "was_price": null,      "unit_price": 38.93,      "review_count": 55,      "price_display": "10,90 €",      "was_price_display": null,      "unit_price_display": "38,93 € / L"    }  ],  "pagination": {    "next": "https://www.castorama.fr/search?term=joint-silicone&page=2",    "page": 1,    "per_page": 48,    "total_pages": 189,    "total_results": 9050  }}