nutrition/off_search

Filter Open Food Facts products by category, brand, label, or Nutri-Score.

0.1 credits / call ($0.0001)

charged on success

What it does

Returns Open Food Facts products matching tag-based filters such as category, brand, label, and nutrition grade. This is a structured filter search (exact tag matches), not free-text search.

Primary use cases

Listing products in a category (e.g. breakfast cereals) sorted by popularity.
Filtering by label (e.g. organic) or Nutri-Score grade.

Good to know

Filters are exact tag matches (e.g. categories_tags_en=breakfast-cereals, nutrition_grades_tags=a). Use sort_by (e.g. "popularity_key", "unique_scans_n"), fields to trim the payload, and page/page_size to paginate. For a single known product use off_product_by_barcode. Data is ODbL: credit "Open Food Facts".

Parameters

pageintegeroptionaldefault: 1

Result page.

fieldsstringoptional

Comma-separated fields to return (e.g. "product_name,brands,nutriscore_grade").

sort_bystringoptional

Sort key (e.g. "popularity_key", "unique_scans_n").

page_sizeintegeroptionaldefault: 24

Results per page (1-100).

brands_tagsstringoptional

Exact brand tag.

labels_tagsstringoptional

Exact label tag (e.g. "organic", "vegan").

categories_tags_enstringoptional

Exact English category tag (e.g. "breakfast-cereals").

nutrition_grades_tagsstringoptional

Nutri-Score grade.