Piloterr Bricorama API
The Bricorama API from Piloterr — 2 operation(s) for bricorama.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/piloterr-com:piloterr-com-bricorama-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Piloterr API Reference Bricorama API
description: Complete API reference documentation.
version: 1.0.0
servers:
- url: https://api.piloterr.com
description: API Server
tags:
- name: Bricorama
paths:
/v2/bricorama/product:
get:
summary: Bricorama Product
description: 'Read one Bricorama product from its URL. You get price, brand, and the product details.
**Credit cost:** 1 credit per call'
operationId: get-bricorama-product
security:
- ApiKeyAuth: []
parameters:
- name: query
in: query
required: true
description: 'Product URL `/p/{slug}/{ean}`.
**Examples:**
```
https://www.bricorama.fr/p/perceuse-visseuse-sans-fil-18v/3999991691267
```
A keyword or a `/search` URL returns 400.'
schema:
type: string
description: 'Product URL `/p/{slug}/{ean}`.
**Examples:**
```
https://www.bricorama.fr/p/perceuse-visseuse-sans-fil-18v/3999991691267
```
A keyword or a `/search` URL returns 400.'
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/is_async'
- $ref: '#/components/parameters/soft_fail'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
ean:
type: string
url:
type: string
name:
type: string
brand:
type: string
price:
type: number
images:
type: array
items:
type: string
currency:
type: string
delivery:
type: string
was_price:
nullable: true
description:
type: string
price_display:
type: string
specifications:
type: array
items:
type: object
properties:
name:
type: string
value:
type: string
discount_display:
nullable: true
was_price_display:
nullable: true
examples:
Perceuse visseuse sans fil 18V:
value:
ean: '3999991691267'
url: https://www.bricorama.fr/p/perceuse-visseuse-sans-fil-18v/3999991691267
name: Perceuse visseuse sans fil 18V
brand: GO/ON
price: 27.9
images:
- https://assets-big.cdn-mousquetaires.com/medias/domain11440/media2624/393739-2ftpvnauip-epreview.jpg
currency: EUR
delivery: Retrait en 2h en magasin
was_price: null
description: 'Découvrez la perceuse visseuse sans fil 18V de la marque GO/ON, un outil performant et pratique conçu pour faciliter tous vos travaux de perçage et de vissage, que vous soyez un bricoleur novice ou expérimenté. Cette perceuse visseuse est équipée d''une batterie Lithium-ion de 1300mAh offrant une bonne autonomie et un temps de charge rapide de seulement 3 heures. Sa puissance de 18 volts assure une efficacité optimale pour une large variété de tâches. Elle dispose d''un mandrin sans clé de 10 mm, ce qui permet un changement rapide et facile des embouts. Grâce à sa fonction réversible et sa vitesse variable, vous pouvez adapter la puissance et la rotation selon vos besoins, pour un contrôle précis et un travail soigné. Le réglage de couple est particulièrement pratique avec 21+1 positions et une force maximale de 16 Nm, ce qui permet de travailler sur différents matériaux sans risque d''endommager les vis ou la surface. Cette perceuse est capable de percer jusqu''à 10 mm dans l''acier et 25 mm dans le bois, ce qui la rend idéale pour des travaux de bricolage courants, comme la fixation d''étagères, le montage de meubles ou la réalisation de petits travaux de construction. Compacte et légère, elle offre une bonne prise en main grâce à sa poignée ergonomique, ce qui limite la fatigue lors d''une utilisation prolongée. Son design sans fil apporte une grande liberté de mouvement et facilite l''accès aux endroits difficiles d''accès sans contrainte de câble. Caractéristiques : Perceuse visseuse sans fil Puissance : 18V Batterie Lithium-ion 1300mAh Chargeur 3 heures Réversible Vitesse variable Mandrin sans clé 10 mm Réglage de couple 16 Nm, 21+1 positions Capacité de perçage acier : 10 mm Capacité de perçage bois : 25 mm GO/ON est une marque reconnue pour son savoir-faire dans la fabrication d’outils électroportatifs destinés aux bricoleurs. Elle allie performance, robustesse et simplicité d’utilisation pour proposer des produits adaptés aux besoins de tous, du novice au plus expérimenté, facilitant ainsi la réalisation de travaux de bricolage variés.'
price_display: 27,90 €
specifications:
- name: Marque
value: GO/ON
- name: Éclairage intégré
value: Non
- name: Vitesse variable
value: Oui
- name: Diamètre de perçage dans le bois (en mm)
value: '25'
- name: Diamètre de perçage dans le métal (en mm)
value: '10'
- name: Type de produit
value: Perceuse visseuse
- name: Hauteur du produit déballé
value: 7 cm
- name: Largeur du produit déballé
value: 19 cm
- name: Profondeur du produit déballé
value: 20 cm
- name: Poids du produit déballé
value: 1.3 kg
- name: Disponibilité des pièces détachées
value: Non communiquée
- name: Hauteur du produit emballé
value: 20.3 cm
- name: Largeur du produit emballé
value: 8.5 cm
- name: Profondeur du produit emballé
value: 21.3 cm
- name: Poids du produit emballé
value: 1.3 kg
- name: Références produit
value: 25077430 / 3999991691267
discount_display: null
was_price_display: null
'400':
description: Bad Request — missing or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Bad Request
'401':
description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKey:
value:
error: Invalid API Key
planRateLimit:
value:
error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
keyQuota:
value:
error: 'Rate limit exceeded for the API key: quota monthly'
'402':
description: Payment Required — your subscription or credit balance is insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Payment required
'500':
description: Internal Server Error — something went wrong on our side.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Internal Error
tags:
- Bricorama
post:
summary: Bricorama Product
description: 'Read one Bricorama product from its URL. You get price, brand, and the product details.
**Credit cost:** 1 credit per call'
operationId: post-bricorama-product
security:
- ApiKeyAuth: []
parameters:
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/is_async'
- $ref: '#/components/parameters/soft_fail'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
query:
type: string
description: 'Product URL `/p/{slug}/{ean}`.
**Examples:**
```
https://www.bricorama.fr/p/perceuse-visseuse-sans-fil-18v/3999991691267
```
A keyword or a `/search` URL returns 400.'
required:
- query
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
ean:
type: string
url:
type: string
name:
type: string
brand:
type: string
price:
type: number
images:
type: array
items:
type: string
currency:
type: string
delivery:
type: string
was_price:
nullable: true
description:
type: string
price_display:
type: string
specifications:
type: array
items:
type: object
properties:
name:
type: string
value:
type: string
discount_display:
nullable: true
was_price_display:
nullable: true
examples:
Perceuse visseuse sans fil 18V:
value:
ean: '3999991691267'
url: https://www.bricorama.fr/p/perceuse-visseuse-sans-fil-18v/3999991691267
name: Perceuse visseuse sans fil 18V
brand: GO/ON
price: 27.9
images:
- https://assets-big.cdn-mousquetaires.com/medias/domain11440/media2624/393739-2ftpvnauip-epreview.jpg
currency: EUR
delivery: Retrait en 2h en magasin
was_price: null
description: 'Découvrez la perceuse visseuse sans fil 18V de la marque GO/ON, un outil performant et pratique conçu pour faciliter tous vos travaux de perçage et de vissage, que vous soyez un bricoleur novice ou expérimenté. Cette perceuse visseuse est équipée d''une batterie Lithium-ion de 1300mAh offrant une bonne autonomie et un temps de charge rapide de seulement 3 heures. Sa puissance de 18 volts assure une efficacité optimale pour une large variété de tâches. Elle dispose d''un mandrin sans clé de 10 mm, ce qui permet un changement rapide et facile des embouts. Grâce à sa fonction réversible et sa vitesse variable, vous pouvez adapter la puissance et la rotation selon vos besoins, pour un contrôle précis et un travail soigné. Le réglage de couple est particulièrement pratique avec 21+1 positions et une force maximale de 16 Nm, ce qui permet de travailler sur différents matériaux sans risque d''endommager les vis ou la surface. Cette perceuse est capable de percer jusqu''à 10 mm dans l''acier et 25 mm dans le bois, ce qui la rend idéale pour des travaux de bricolage courants, comme la fixation d''étagères, le montage de meubles ou la réalisation de petits travaux de construction. Compacte et légère, elle offre une bonne prise en main grâce à sa poignée ergonomique, ce qui limite la fatigue lors d''une utilisation prolongée. Son design sans fil apporte une grande liberté de mouvement et facilite l''accès aux endroits difficiles d''accès sans contrainte de câble. Caractéristiques : Perceuse visseuse sans fil Puissance : 18V Batterie Lithium-ion 1300mAh Chargeur 3 heures Réversible Vitesse variable Mandrin sans clé 10 mm Réglage de couple 16 Nm, 21+1 positions Capacité de perçage acier : 10 mm Capacité de perçage bois : 25 mm GO/ON est une marque reconnue pour son savoir-faire dans la fabrication d’outils électroportatifs destinés aux bricoleurs. Elle allie performance, robustesse et simplicité d’utilisation pour proposer des produits adaptés aux besoins de tous, du novice au plus expérimenté, facilitant ainsi la réalisation de travaux de bricolage variés.'
price_display: 27,90 €
specifications:
- name: Marque
value: GO/ON
- name: Éclairage intégré
value: Non
- name: Vitesse variable
value: Oui
- name: Diamètre de perçage dans le bois (en mm)
value: '25'
- name: Diamètre de perçage dans le métal (en mm)
value: '10'
- name: Type de produit
value: Perceuse visseuse
- name: Hauteur du produit déballé
value: 7 cm
- name: Largeur du produit déballé
value: 19 cm
- name: Profondeur du produit déballé
value: 20 cm
- name: Poids du produit déballé
value: 1.3 kg
- name: Disponibilité des pièces détachées
value: Non communiquée
- name: Hauteur du produit emballé
value: 20.3 cm
- name: Largeur du produit emballé
value: 8.5 cm
- name: Profondeur du produit emballé
value: 21.3 cm
- name: Poids du produit emballé
value: 1.3 kg
- name: Références produit
value: 25077430 / 3999991691267
discount_display: null
was_price_display: null
'400':
description: Bad Request — missing or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Bad Request
'401':
description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKey:
value:
error: Invalid API Key
planRateLimit:
value:
error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
keyQuota:
value:
error: 'Rate limit exceeded for the API key: quota monthly'
'402':
description: Payment Required — your subscription or credit balance is insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Payment required
'500':
description: Internal Server Error — something went wrong on our side.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Internal Error
tags:
- Bricorama
/v2/bricorama/search:
get:
summary: Bricorama Search
description: 'Search Bricorama by keyword or search URL and page the home-improvement grid.
**Credit cost:** 1 credit per call'
operationId: get-bricorama-search
security:
- ApiKeyAuth: []
parameters:
- name: query
in: query
required: true
description: '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=`.'
schema:
type: string
description: '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=`.'
- name: page
in: query
required: false
description: Page from 1. Sent as ?page= on the listing.
schema:
type: number
description: Page from 1. Sent as ?page= on the listing.
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/is_async'
- $ref: '#/components/parameters/soft_fail'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
results:
type: array
items:
type: object
properties:
ean:
type: string
url:
type: string
name:
type: string
brand:
type: string
image:
type: string
price:
type: number
seller:
nullable: true
currency:
type: string
delivery:
type: string
position:
type: integer
was_price:
nullable: true
availability:
type: string
price_display:
type: string
discount_display:
nullable: true
was_price_display:
nullable: true
pagination:
type: object
properties:
next:
type: string
page:
type: integer
per_page:
type: integer
total_pages:
nullable: true
total_results:
nullable: true
examples:
perceuse, first product:
value:
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
'400':
description: Bad Request — missing or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Bad Request
'401':
description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKey:
value:
error: Invalid API Key
planRateLimit:
value:
error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
keyQuota:
value:
error: 'Rate limit exceeded for the API key: quota monthly'
'402':
description: Payment Required — your subscription or credit balance is insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Payment required
'500':
description: Internal Server Error — something went wrong on our side.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Internal Error
tags:
- Bricorama
post:
summary: Bricorama Search
description: 'Search Bricorama by keyword or search URL and page the home-improvement grid.
**Credit cost:** 1 credit per call'
operationId: post-bricorama-search
security:
- ApiKeyAuth: []
parameters:
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/is_async'
- $ref: '#/components/parameters/soft_fail'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
query:
type: string
description: '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:
type: number
description: Page from 1. Sent as ?page= on the listing.
required:
- query
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
results:
type: array
items:
type: object
properties:
ean:
type: string
url:
type: string
name:
type: string
brand:
type: string
image:
type: string
price:
type: number
seller:
nullable: true
currency:
type: string
delivery:
type: string
position:
type: integer
was_price:
nullable: true
availability:
type: string
price_display:
type: string
discount_display:
nullable: true
was_price_display:
nullable: true
pagination:
type: object
properties:
next:
type: string
page:
type: integer
per_page:
type: integer
total_pages:
nullable: true
total_results:
nullable: true
examples:
perceuse, first product:
value:
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
'400':
description: Bad Request — missing or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Bad Request
'401':
description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKey:
value:
error: Invalid API Key
planRateLimit:
value:
error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
keyQuota:
value:
error: 'Rate limit exceeded for the API key: quota monthly'
'402':
description: Payment Required — your subscription or credit balance is insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Payment required
'500':
description: Internal Server Error — something went wrong on our side.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Internal Error
tags:
- Bricorama
components:
parameters:
fields:
name: fields
in: query
required: false
description: Comma-separated list of response fields to return, with dot notation for nested fields (e.g. `name,location.city`).
schema:
type: string
is_async:
name: is_async
in: query
required: false
description: 'Run the request as a background job: the API answers `202` with a `job_id` to poll on `GET /v1/jobs/{id}`.'
schema:
type: boolean
default: false
soft_fail:
name: soft_fail
in: query
required: false
description: Return HTTP 200 even when the request fails; the error is in the `error` field of the body.
schema:
type: boolean
default: false
schemas:
ErrorResponse:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable error message.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: Your API key. Include it in the x-api-key header for every request.