Guía para desarrolladores de Noms

Noms es una API REST para datos nutricionales: alimentos, marcas, nutrientes y grupos de alimentos, depurados y normalizados en una sola estructura consistente. Esta guía es el camino corto para construir con ella. Consigue una API key, haz tu primer request y lleva los ejemplos directo a tu app.

Esto es una guía, no una referencia exhaustiva. Para la lista completa y siempre actualizada de cada endpoint, parámetro y campo, abre el explorador de la API, donde puedes autenticarte y ejecutar requests en vivo desde el navegador.

Inicio rápidoHaz tu primer request en cinco minutos.

Datos nutricionalesCómo encajan los valores por 100 y las porciones.

AutenticaciónConsigue una API key y mándala en cada request.

Consultas y modelo de datosBusca, filtra, ordena, pagina y modela respuestas.

Escenarios comunesRecetas de código listas para copiar.

Rate limits y cuotasCuotas, headers RateLimit y cómo consultar tu uso.

SoporteCómo contactarnos, tiempos de respuesta y la página de estado.

Referencia completa de la APICada endpoint, parámetro y campo. Interactivo y siempre actualizado.

Abrir el explorador

Qué puedes construir

Búsqueda por código de barras. Escanea o escribe un EAN/UPC y resuelve el producto.
Búsqueda de alimentos. Un buscador que tolera erratas sobre todo el catálogo.
Etiquetas nutricionales. Obtén el desglose completo de nutrientes por 100 g de un alimento.
Funciones de dieta y fitness. Ordena y filtra alimentos por nutriente: alto en proteína, bajo en azúcar, etc.

Cómo está estructurada la API

Unas pocas convenciones se mantienen en todos los endpoints. Apréndelas una vez y toda la API se vuelve predecible.

Una URL base. Todo vive bajo https://api.noms.sh/v1.
Un header de autenticación. Manda tu API key como X-API-Key en cada request.
Envoltorios JSON. Un recurso individual vuelve como { "data": { … } }; una lista como { "data": [ … ], "links": { … }, "meta": { … } }.
Paginación por keyset. Las listas se paginan por cursor. Sigue links.next para avanzar a la siguiente página; nunca cuentes desplazamientos.
Modela la respuesta. Trae recursos relacionados con include= y recorta campos con fields[...], para pedir exactamente lo que muestras.
Errores RFC 9457. Las fallas son application/problem+json con type, title, status, detail y un doc_url que enlaza a la explicación.

Haz tu primer request →