The Picard Product API returns full product page data from picard.fr. Pass a product URL or numeric reference (050314) and receive structured JSON with pricing, images, description, breadcrumb, Nutri-Score, Planet-Score, origin and reviews.
Piloterr fetches the product HTML page via HTTP and parses the SFCC markup. No browser rendering required.
Use Picard Search to discover listings, then Picard Product for the full record.
GET https://api.piloterr.com/v2/picard/product?query=050314
GET https://api.piloterr.com/v2/picard/product?query=https://www.picard.fr/produits/puree-patate-douce-000000000000050314.html
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Product URL (/produits/...html) or numeric reference |
return_page_source |
boolean |
no |
Raw HTML as {\"result\": \"...\"} (default: false) |
| Field |
Type |
Description |
product_id |
string |
18-digit SFCC product id |
reference |
string |
Short Picard reference |
title |
string |
Product title |
url |
string |
Canonical product URL |
price |
number | null |
Displayed price |
currency |
string |
ISO currency (EUR) |
unit_price |
number | null |
Parsed unit price per kg |
unit_price_text |
string | null |
Unit price label |
packaging |
string | null |
Pack size text |
brand |
string | null |
Brand name |
label |
string | null |
Product label badge |
description |
string | null |
Long description |
origin |
string | null |
Origin / sourcing text |
image_url |
string | null |
Main image |
images |
string[] | null |
Gallery URLs |
rating |
number | null |
Average rating |
reviews_count |
integer | null |
Review count |
category |
string | null |
Top category |
subcategory |
string | null |
Subcategory |
subcategory2 |
string | null |
Range / sub-range |
range |
string | null |
Product range |
nutriscore |
string | null |
Nutri-Score grade |
planetscore |
string | null |
Planet-Score grade |
gtin |
string | null |
GTIN / EAN |
availability |
string | null |
Stock code or label |
breadcrumb |
array |
{name, url, position} trail |
- Picard Search to discover listings
- Picard Product for full PDP JSON (this endpoint)
| Code |
Meaning |
400 |
Missing or invalid query |
404 |
Product not found or unparsable page |
500 |
Network or parsing error |
- Reference-only queries (
050314) resolve via internal grid search.
- Picard.fr only (France).
- Costs 1 credit per call (HTTP crawler).
- PDP enrichment: description, gallery, breadcrumb, scores
- Price monitoring: price and unit price per kg
- Retail intel: origin, labels and category taxonomy