Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/EstefanoARG/FridgeRadar/llms.txt

Use this file to discover all available pages before exploring further.

Tengo Hambre (“I’m hungry”) surfaces recipes you can cook using ingredients that are about to expire in your household’s inventory. The engine scores each candidate recipe by how many of its required ingredients match items currently in stock, ranking results by porcentaje_match descending so the best-fit recipes appear first. When solo_criticos=true (the default), only items in amarillo or rojo freshness state are considered — helping you use up the most at-risk food before it goes to waste. A valid Bearer token is required.

​
Get Recipe Suggestions

Returns a ranked list of recipe suggestions tailored to the household’s expiring inventory.
​
id_hogar
integer
required
The unique identifier of the household whose inventory is analysed for recipe matches.
​
solo_criticos
boolean
default:"true"
When true, only inventory items with a semáforo state of amarillo or rojo are used as candidate ingredients. Set to false to consider all items regardless of freshness state.
​
limite
integer
default:"10"
Maximum number of recipe suggestions to return. Increase this value to paginate through a wider set of matches.
curl -X GET "https://api.fridgeradar.app/api/v1/tengo-hambre/3?solo_criticos=true&limite=5" \
  -H "Authorization: Bearer <token>"
Response fields — SugerenciaResponse
​
id_receta
integer
required
Unique identifier of the matched recipe.
​
nombre
string
required
Display name of the recipe.
​
descripcion
string | null
Optional longer description of the recipe. May be null if no description is stored.
​
tiempo_preparacion
integer | null
Estimated preparation time in minutes, or null if unknown.
​
dificultad
string
required
Difficulty level of the recipe, e.g. facil, media, or dificil.
​
porciones
integer | null
Number of servings the recipe yields, or null if not specified.
​
imagen
string | null
URL of a cover image for the recipe, or null if unavailable.
​
calorias
integer | null
Approximate calories per serving, or null if not available.
​
porcentaje_match
float
required
Match score between 0 and 100 representing what percentage of the recipe’s required ingredients are present in the household’s inventory. Results are sorted by this field descending.
​
usa_criticos
boolean
required
true if at least one ingredient used by this recipe is currently in amarillo or rojo freshness state, indicating the recipe actively helps reduce food waste.
Set solo_criticos=false when you want broader inspiration from all available pantry items, not just those close to expiry.

Build docs developers (and LLMs) love

Get started for freeTalk to us