Skip to main content
Network status
Log in
Piloterr
Back to library

Picard Search API

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.

Active1 credit = 1 requestGET/v2/picard/search
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Picard Search API returns frozen food product listings from picard.fr. Pass a keyword or a full search URL, optionally with page, and receive structured JSON with prices, Nutri-Score, ratings, availability and pagination.

Piloterr calls the SFCC AJAX endpoint Search-UpdateGrid and parses the HTML grid. No browser rendering required.

Use each result url or product_id with Picard Product for full PDP data.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/picard/search?query=patate+douce
GET https://api.piloterr.com/v2/picard/search?query=patate+douce&page=1
GET https://api.piloterr.com/v2/picard/search?query=https://www.picard.fr/recherche?q=patate&lang=fr_FR

ParametersLink to Parameters

Parameter Type Required Description
query string yes Keyword or full Picard search URL
page integer no 1-based page number (default: 1, 24 results per page)
return_page_source boolean no Raw HTML as {\"result\": \"...\"} (default: false)

Listings (results[])Link to Listings (results[])

Field Type Description
product_id string 18-digit SFCC product id
reference string Short Picard reference
title string Product title
url string Absolute product URL
image_url string | null Card image
price number | null Displayed price
currency string ISO currency (EUR)
unit_price_text string | null Unit price label (e.g. 5,77 €/kg)
packaging string | null Pack size text
rating number | null Average rating
reviews_count integer | null Review count (often null on grid)
category string | null Top category
subcategory string | null Subcategory
nutriscore string | null Nutri-Score grade
availability string | null Stock label (en stock, …)

PaginationLink to Pagination

Field Type Description
page integer Current page
per_page integer Page size (24)
count integer Results on this page
has_next boolean More pages available
next integer | null Next page number

Picard workflowLink to Picard workflow

  1. Picard Search to discover listings (this endpoint)
  2. Picard Product for full PDP JSON

Error codesLink to Error codes

Code Meaning
400 Missing or invalid query
404 Empty or unparsable search grid
500 Network or parsing error

NotesLink to Notes

  • Picard.fr only (France).
  • Costs 1 credit per call (HTTP crawler).

Main use casesLink to Main use cases

  • Catalog discovery: harvest product ids and URLs by keyword
  • Price monitoring: track listing prices and unit prices
  • Assortment intel: Nutri-Score, categories and availability at scale

Related APIs

Expand your data capabilities with these complementary tools.

View All
Picard Product/v2/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.

GET1 credit = 1 requestActive

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included
Start free (+500 credits)PiloterrTalk to a data expert