Piloterr

Picard Search

GET
/v2/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

Authorization

ApiKeyAuth
headerx-api-key<token>

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

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.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/picard/search?query=string'
Example Response
{  "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  }}