# Folksonomy Engine API

**Canonical:** https://apis.io/apis/open-food-facts/open-food-facts-folksonomy/  
**Provider:** Open Food Facts — https://apis.io/providers/open-food-facts/  
**Base URL:** https://api.folksonomy.openfoodfacts.org  
**Documentation:** https://api.folksonomy.openfoodfacts.org/docs

Folksonomy Engine API is one of 12 APIs that [Open Food Facts](https://apis.io/providers/open-food-facts/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Folksonomy and Tags. The published artifact set on APIs.io includes an OpenAPI specification.

The Folksonomy Engine lets contributors attach free property/value pairs to Open Food Facts products. It serves its own OpenAPI 3.1 document and uses an OAuth2 password flow against the Open Food Facts account system.

## Operations (20)

| Method | Path | Summary |
|---|---|---|
| GET | `/` | Hello |
| POST | `/auth` | Authentication |
| POST | `/auth_by_cookie` | Authentication By Cookie |
| GET | `/products/stats` | Product Stats |
| GET | `/products` | Product List |
| GET | `/product/{product}` | Product Tags List |
| GET | `/product/{product}/{k}` | Product Tag |
| DELETE | `/product/{product}/{k}` | Product Tag Delete |
| GET | `/product/{product}/{k}/versions` | Product Tag List Versions |
| PUT | `/product` | Product Tag Update |
| POST | `/product` | Product Tag Add |
| GET | `/keys` | Keys List |
| GET | `/values/{k}` | Get Unique Values |
| GET | `/ping` | Pong |
| POST | `/admin/property/check-clash` | Check Property Clash |
| POST | `/admin/property/rename` | Rename Property |
| DELETE | `/admin/property` | Delete Property |
| GET | `/user/me` | Get User Info |
| POST | `/admin/value/replace` | Replace Value |
| DELETE | `/admin/value` | Delete Value |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/open-food-facts/refs/heads/main/openapi/open-food-facts-folksonomy-openapi.json
- **OpenAPI** — https://api.folksonomy.openfoodfacts.org/openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/open-food-facts/refs/heads/main/overlays/open-food-facts-folksonomy-overlay.yaml

## Other Open Food Facts APIs (11)

- [Open Food Facts API v2](https://apis.io/apis/open-food-facts/open-food-facts-api-v2/)
- [Open Food Facts API v3](https://apis.io/apis/open-food-facts/open-food-facts-api-v3/)
- [Open Prices API](https://apis.io/apis/open-food-facts/open-food-facts-open-prices/)
- [Search-a-licious API](https://apis.io/apis/open-food-facts/open-food-facts-search-a-licious/)
- [Facets Knowledge Panels API](https://apis.io/apis/open-food-facts/open-food-facts-facets-knowledge-panels/)
- [NutriPatrol API](https://apis.io/apis/open-food-facts/open-food-facts-nutripatrol/)
- [Open Food Facts Cgi API](https://apis.io/apis/open-food-facts/open-food-facts-cgi-api/)
- [Open Food Facts Product API](https://apis.io/apis/open-food-facts/open-food-facts-product-api/)
- [Open Food Facts Search API](https://apis.io/apis/open-food-facts/open-food-facts-search-api/)
- [Open Food Facts Taxonomy API](https://apis.io/apis/open-food-facts/open-food-facts-taxonomy-api/)
- [Open Food Facts Taxonomy Suggestions API](https://apis.io/apis/open-food-facts/open-food-facts-taxonomy-suggestions-api/)

## Tags

Folksonomy, Tags

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/open-food-facts/open-food-facts-folksonomy/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/open-food-facts/.