Product compatibility by EAN

Look up a packaged food product by its EAN and get its nutritional compatibility (vegetarian, vegan, gluten-free, allergens, ...), computed live from the label since the master catalog stores no precomputed flags. Decode flagId/outcomeId via the 'Definitions' endpoints. Merge the response with the other by-EAN endpoints on the 'ean' key. Use Cases: SHOPPING APP WITH BARCODE SCANNER • The user scans a barcode and instantly sees whether the product fits their lifestyle and allergen profile. GROCERY — CATALOG ENRICHMENT • Enrich every catalog product with lifestyle and allergen compatibility, starting from just the EAN.

GET
/products/{ean}/compatibility
Products
Cost: 60 credits
Get API KeyView pricing

Product information by EAN

GET /products/{ean}

Product macronutrients by EAN

GET /products/{ean}/macronutrients

Response

200
application/json
object

ProductCompatibilityResult

Nutritional compatibility of a product looked up by EAN, computed live from its ingredients and label (the master catalog stores no precomputed flags). Disjoint from the basic-info and macronutrients by-EAN endpoints: merge the responses on 'ean'.

object

ean

Normalized EAN: the canonical key used to merge the responses of the by-EAN endpoints

string

compatibility

object[]

AnalysisResultItem

Single nutritional compatibility result for one lifestyle flag - contains flag and outcome identifiers that can be decoded using the 'Definitions' endpoints to obtain localized descriptions

object

flagId

Lifestyle flag identifier (e.g., vegetarian, vegan, gluten-free) - see 'Definitions' endpoints to decode this ID and get localized descriptions

integer<int16>

outcomeId?

Outcome type identifier indicating the compatibility result - see 'Definitions' endpoints to decode this ID and get localized descriptions. Null when no outcome is determined

integer<uint8> | null
204
application/json

No Content

No schemas are available for this endpoint.

401
application/json
object

Unauthorized

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

Forbidden

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

Not Acceptable

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

Unprocessable Entity

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

Too Many Requests (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

Internal Server Error

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
502
application/json
object

Bad Gateway (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
504
application/json
object

Gateway Timeout (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string

Product information by EAN

GET /products/{ean}

Product macronutrients by EAN

GET /products/{ean}/macronutrients