Piloterr

Bricorama Search

GET
/v2/bricorama/search

Search Bricorama by keyword or search URL and page the home-improvement grid.

Credit cost: 1 credit per call

Autorisierung

ApiKeyAuth
x-api-key<token>

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

In: header

Abfrageparameter

query*string

Keyword, or a Bricorama /search URL.

Examples:

perceuse
https://www.bricorama.fr/search?q=perceuse

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

page?number

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

Antworttext

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/bricorama/search?query=string"
{  "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  }}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}