Piloterr

Picard Search

Picard Search API. Search frozen food listings on picard.fr by keyword or URL. Parses SFCC Search-UpdateGrid HTML; returns prices, Nutri-Score, ratings and pagination.

Credit cost: 1 credit per call

GET
/v2/picard/search

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

Search keyword or full Picard search URL.

Examples:

patate douce
https://www.picard.fr/recherche?q=patate&lang=fr_FR

Use Picard Product on any result url or product_id for full PDP data.

page?number

1-based page number (24 results per page via SFCC Search-UpdateGrid). Default: 1.

Range1 <= value <= 500
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/search?query=string"
{
  "results": [
    {
      "url": "https://www.picard.fr/produits/inedites-patate-douce-patates-douce-enrobees-000000000000050935.html",
      "price": 3.4,
      "title": "Inédites à la patate douce, patates douce enrobées",
      "rating": 4.56,
      "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/dw8a619f76/produits/000000000000050935_E.jpg?sw=258&sh=151&q=30",
      "packaging": "le sachet de 500 g",
      "reference": "50935",
      "nutriscore": "C",
      "product_id": "000000000000050935",
      "subcategory": "Féculents",
      "availability": "en stock",
      "reviews_count": null,
      "unit_price_text": "6,80 €/kg"
    },
    {
      "url": "https://www.picard.fr/produits/puree-patate-douce-000000000000050314.html",
      "price": 2.6,
      "title": "Purée de patate douce",
      "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?sw=258&sh=151&q=30",
      "packaging": "la boîte de 450 g",
      "reference": "50314",
      "nutriscore": "A",
      "product_id": "000000000000050314",
      "subcategory": "Légumes cuisinés",
      "availability": "en stock",
      "reviews_count": null,
      "unit_price_text": "5,77 €/kg"
    }
  ],
  "pagination": {
    "next": null,
    "page": 1,
    "count": 21,
    "has_next": false,
    "per_page": 24
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}