NauTritivadevelopers
Endpoints

Ranked, filtered food search with optional external fallback

GET/v1/search

Searches the local canonical catalog first across accent-insensitive name, brand, barcode, and FoodEx2 fields. Portuguese records receive ranking priority unless an explicit region filter is supplied. By default Open Food Facts and Portuguese Wikipedia are queried only when local results are empty; FatSecret is explicit opt-in. External results remain separate and non-canonical.

Parâmetros

qstringqueryobrigatório
limitintegerquerydefault 20
offsetintegerquerydefault 0
typegeneric | brandedquery
sourceinsa | off | brand | manual | ext_05query
regionstringquery
Exact region filter. Omit it to retain Portugal-first ranking.
categorystringquery
fallbackauto | always | nonequerydefault auto
providersstringquery
Comma-separated: off,fatsecret,wikipedia. Default: off,wikipedia.
languagestringquerydefault pt
Wikipedia language (pt or en).

Respostas

200Matching products
401Missing/invalid API key
429Rate limit or quota exceeded
curl "https://nautritiva.vercel.app/v1/search?q=iogurte%20grego" \
  -H "Authorization: Bearer $NTV_KEY"
OpenAPI JSON →