API v3
Modern Open Food Facts API with enhanced capabilities, improved performance, and developer-friendly design
Open Food Facts API v3
The next generation Open Food Facts API provides enhanced capabilities, improved performance, and modern RESTful design patterns. Built with developer experience in mind, API v3 offers cleaner endpoints, better data structures, and comprehensive validation.
API v3 represents the future of Open Food Facts APIs, featuring improved design, better error handling, enhanced developer experience, and optimized performance for modern applications.
API Categories
Products
Modern endpoints for retrieving and managing product data with improved performance
Images
Advanced image upload, processing, and management capabilities with validation
Knowledge Panels
Access structured knowledge panels for product facets and categories
Taxonomy
Improved access to Open Food Facts taxonomies and classification systems
Base URL
All API v3 requests use the modern endpoint structure:
https://world.openfoodfacts.org/api/v3Key Improvements Over v2
Clean, predictable URL patterns following REST conventions with consistent HTTP methods
Optimized database queries, response caching, and reduced payload sizes
Detailed error responses with helpful debugging information and consistent error codes
Improved data structures, consistent field naming, and comprehensive documentation
Request validation with clear error messages and data integrity checks
Key Features
Data Operations
- Product Management: Full CRUD operations with atomic transactions
- Batch Processing: Efficient handling of multiple product operations
- Search & Filtering: Advanced search capabilities with faceting
- Version Control: Track changes and maintain data history
Integration Features
- Authentication: Multiple authentication methods including OAuth2
- Rate Limiting: Fair usage policies with clear limits and headers
- Webhooks: Real-time notifications for data changes
- SDK Support: Official client libraries for popular programming languages
API v3 maintains full compatibility with Open Food Facts data while providing a significantly improved developer experience and better performance characteristics.
Migration from v2
While migrating from API v2 to v3, note that endpoint structures and some response formats have changed. Review the migration guide and test thoroughly before switching production systems.
Getting Started
- Explore the API: Start with Products to understand the improved data structures
- Authentication: Set up authentication for write operations
- Test Integration: Use the sandbox environment for development
- Production: Deploy with proper error handling and rate limiting
Development Status
API v3 is actively maintained with regular updates. Check our changelog for new features, improvements, and breaking changes.