Piloterr

Picard Product

Picard Product API. Fetch full frozen food product data from a Picard URL or reference. Returns pricing, images, description, Nutri-Score, Planet-Score, breadcrumb and reviews.

Credit cost: 1 credit per call

GET
/v2/picard/product

Authorization

ApiKeyAuth
x-api-key<token>

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

In: header

Query Parameters

query*string

Picard product URL or numeric reference.

Examples:

050314
https://www.picard.fr/produits/puree-patate-douce-000000000000050314.html
return_page_source?boolean

When true, return the raw HTML as {"result": "..."} instead of structured JSON. Defaults to false.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/picard/product?query=string"
{
  "url": "https://www.picard.fr/produits/puree-patate-douce-000000000000050314.html",
  "gtin": "3270160503148",
  "brand": "Picard",
  "label": "Convient aux végétariens",
  "price": 2.6,
  "range": "Purées",
  "title": "Purée de patate douce",
  "images": [
    "https://www.picard.fr/dw/image/v2/AAHV_PRD/on/demandware.static/-/Sites-catalog-picard/default/dwea0e1bd9/produits/legumes/edition/000000000000050314_E1.jpg?sh=200",
    "https://www.picard.fr/dw/image/v2/AAHV_PRD/on/demandware.static/-/Sites-catalog-picard/default/dwea0e1bd9/produits/legumes/edition/000000000000050314_E1.jpg?sw=672&sh=392&q=30&frz-v=115"
  ],
  "origin": "Produit élaboré en France à partir de patate douce cultivée en Espagne et au Portugal",
  "rating": 4.7,
  "category": "Légumes et fruits",
  "currency": "EUR",
  "image_url": "https://www.picard.fr/dw/image/v2/AAHV_PRD/on/demandware.static/-/Sites-catalog-picard/default/dwea0e1bd9/produits/legumes/edition/000000000000050314_E1.jpg?sh=200",
  "packaging": "la boîte de 450 g",
  "reference": "050314",
  "breadcrumb": [
    {
      "url": "https://www.picard.fr/",
      "name": "Accueil",
      "position": 1
    },
    {
      "url": "https://www.picard.fr/rayons",
      "name": "Rayons",
      "position": 2
    },
    {
      "url": "https://www.picard.fr/rayons/legumes-et-fruits",
      "name": "Légumes et fruits",
      "position": 3
    },
    {
      "url": "https://www.picard.fr/produits/puree-patate-douce-000000000000050314.html",
      "name": "Purée de patate douce",
      "position": 6
    }
  ],
  "nutriscore": "A",
  "product_id": "000000000000050314",
  "unit_price": 5.77,
  "description": "Redécouvrez un légume oublié avec cette purée de patate douce au petit goût de châtaigne.",
  "planetscore": "C",
  "subcategory": "Légumes cuisinés",
  "availability": "InStock",
  "subcategory2": "Purées",
  "reviews_count": 336,
  "unit_price_text": "Prix au kilo\n5,77 €/kg"
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}