GET /api/v2/search
openfoodfacts.org:open-food-facts-api
Summary: Search products
Operation ID: searchProducts
Auth: unknown
Operation ID: searchProducts
Auth: unknown
Description
Search for products using various criteria including text search, categories, brands, labels, nutrition grades, and more.
Parameters (12)
additives_tags
(string, query, optional)
Filter by additives
allergens_tags
(string, query, optional)
Filter by allergens present in product
brands_tags
(string, query, optional)
Filter by brand
categories_tags_en
(string, query, optional)
Filter by category (English tag)
countries_tags_en
(string, query, optional)
Filter by country where product is sold
fields
(string, query, optional)
Comma-separated list of fields to return
labels_tags_en
(string, query, optional)
Filter by label (e.g., organic, fair-trade)
nutrition_grades
(string, query, optional)
Filter by Nutri-Score grade (a, b, c, d, e, unknown)
Constraints: {'enum': ['a', 'b', 'c', 'd', 'e', 'unknown']}
page
(integer, query, optional, default: 1)
Page number for pagination
page_size
(integer, query, optional, default: 20)
Number of products per page (max 100)
Constraints: {'maximum': 100}
search_terms
(string, query, optional)
Text to search for in product names, brands, categories
sort_by
(string, query, optional, default: popularity)
Sort order for results
Constraints: {'enum': ['popularity', 'product_name', 'created_t', 'last_modified_t']}
Examples (1)
| Title | Type | URL | Action |
|---|---|---|---|
| Search products | openapi-spec |
https://world.openfoodfacts.org/api/v2/search?search_terms=chocolate&categories_tags_en=chocolates&brands_tags=nutella&labels_tags_en=organic&nutrition_grades=a&allergens_tags=en:milk&additives_tags=en:e330&countries_tags_en=france&page=1&page_size=20&fields=code,product_name,brands,nutrition_grades,image_url |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:44:50.056994 | 200 | 12146ms |