# Recipe API
A Recipe API is like a personal chef, providing you with a vast collection of recipes and culinary inspiration. It helps you find new recipes, explore cuisines, and even build food-related apps, making cooking easier and more enjoyable. Think of it as a culinary treasure trove at your fingertips!
## Base URL
https://santechapi.vercel.app
### Authentication
```
headers : {
"token" : {YOUR API KEY}
}
```
**Endpoint:** `recipe/search/{:q}`
### Parameters:
* {q}: Random input text from the user
*HTTP Method: `Get`*
**Example request**
```
GET/recipe/search/upma
```
**Example Response**
`200`
```
[
{
"recipe": {
"uri": "http://www.edamam.com/ontologies/edamam.owl#recipe_14f7007bacbea3e1e40de479f303b53f",
"label": "Broccoli, Carrot, and Pepper Upma",
"image": "https://edamam-product-images.s3.amazonaws.com/web-img/255/2551d727a1101da32aaa2338a2a5878c.jpg?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEC0aCXVzLWVhc3QtMSJHMEUCIE4KuF1PBxfI%2FPV3NxBIPhlVORX8gJfRrj%2BekPfGjCOKAiEA6MELZ%2BF4t0FB%2FPXTXHFBO%2FmGbTGqSjAv%2BGqxos28mIUquQUIdhAAGgwxODcwMTcxNTA5ODYiDKu%2BnLGJDNBCZuLPcyqWBZ%2BUZr%2Bbx81TykkHOqpQ%2FE14in3iphm7BTQ8jRe8NpHnuUSA9V6x72pWohhd%2FnhoKbrVoaB%2BHP%2FZ8k6AiqselGp%2FRiaQrvn19azLCSWDHeLykASG4%2Bo3drWOetlmBSTAsxsDxRnFgOv6OfEL7vbrrJsMgc5FOkAuBd2%2B9cmeR7oWwMwNXKKjWnJr2sL6BsofSc6qMLd82E8syLzTBXpcBxrcH3s8HJvxiFMbjSR%2FBUoVLUF1IkhaJGiNVav9JGvglyPhzUVRYaViZ6sb6DKHEqZLwvbr3REkiChbqtCb5Opf8eix1u5dohS6f3dTMRIz3AumweSRg1oiPfwgMRIPYmpke8BMjglgqCPDkzUR0IAIvgn%2BE2uo4%2F%2FknQwuxYwQ%2FuKy51a9pJ9xwTRWCh4ZfSUyHaQPPK%2FC4DD%2FpWTEJI%2FoBDDg3YQLs2e0dvdGyrOulZlux2yZPS2udkecNtxVm%2Fi%2BbI9fiOshwf4pGXgCgrahRCfaaOFfMGUsVfxkVUqOC2v%2BGIvBXE2yN7u%2FMlfPACwKpsd2yfn8eazCOst4KZGsGaiB56IF%2BdVNhCBBT4dCdUzChGz2e8d3GXm4eyaKHNgMiqUjCNJLqo3IU3DccVFA0mzYEt697vgI4WlYPwzhBLBGMamF%2B0NoVZnf61JIgiBEjieXI6DPkqpFkPRiNvGAixpzeaf%2FIK7Kh%2FpY%2BZAWPgUfwxP42dBqymtqDL1aL7WkzreJSdlWbSu3UNUv3gyfb%2BdKY1213PiIb1G8AYjMfU8ayNN7yrg6ihXyGKy6AR8gEwhTBit7kNoAx2epiM324nHsvVzub%2BYa8AGL0yoAp4vC1AKD%2Fhc5mbPuFr%2F0SmEFHtiL7Pelfy0UlfIEsWzLMZRwfDHkMK256rcGOrEBqkaPR9qdnMiueZqeoCCg%2BQ0Ge6SQnOyh47bGa7lFFNejqEyMC79ZbsgBYKQrRtQiyJgsY%2F6TfTWd1ca5Liee0UZEzjI8PYy%2Fc5JS%2BslKi0Wm80tWPrMR20XyrDJ6pYT0FyuX9%2FlmJGjOhp8pnoJnWUy9GhgTXSU6j9rGOCOx5MS40fr644RXtAZY9%2FlmN69TKyqiAU4tEikLANYcPkNXDS7mf0en4AEwIRXL1Oc7rcHV&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240930T130447Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=ASIASXCYXIIFFIORE6UZ%2F20240930%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=07030a96ea94b7b0728fa2de2c89c582bcc6224dc14fcb960d14d1d559856d10",
"source": "Foodista",
"url": "http://www.foodista.com/recipe/YGK6KHLV/broccoli-carrot-and-pepper-upma",
"shareAs": "http://www.edamam.com/recipe/broccoli-carrot-and-pepper-upma-14f7007bacbea3e1e40de479f303b53f/upma",
"yield": 4,
"dietLabels": [
"Low-Fat",
"Low-Sodium"
],
"healthLabels": [
"Sugar-Conscious",
"Vegan",
"Vegetarian",
"Pescatarian",
"Dairy-Free",
"Egg-Free",
"Peanut-Free",
"Tree-Nut-Free",
"Soy-Free",
"Fish-Free",
"Shellfish-Free",
"Pork-Free",
"Red-Meat-Free",
"Crustacean-Free",
"Celery-Free",
"Mustard-Free",
"Sesame-Free",
"Lupine-Free",
"Mollusk-Free",
"Alcohol-Free",
"Kosher",
"Immuno-Supportive"
],
"cautions": [
"Sulfites"
],
"ingredientLines": [
"1 cup semolina or an upma premix",
"1 cup broccoli",
"1/2 cup carrot",
"1/2 cup green peppers",
"1 large green chilli",
"1 cup of water",
"1 teaspoon of vegetable oil",
"a lime"
],
"ingredients": [
{
"text": "1 cup semolina or an upma premix",
"quantity": 1,
"measure": "cup",
"food": "semolina",
"weight": 167,
"foodCategory": "grains",
"image": "https://www.edamam.com/food-img/78f/78fef871275ab078606ea747e446150e.jpg"
},
{
"text": "1 cup broccoli",
"quantity": 1,
"measure": "cup",
"food": "broccoli",
"weight": 91,
"foodCategory": "vegetables",
"image": "https://www.edamam.com/food-img/3e4/3e47317a3dd54dc911b9c44122285df1.jpg"
},
{
"text": "1/2 cup carrot",
"quantity": 0.5,
"measure": "cup",
"food": "carrot",
"weight": 61,
"foodCategory": "vegetables",
"image": "https://www.edamam.com/food-img/121/121e33fce0bb9546ed7d060b6c114e29.jpg"
},
{
"text": "1/2 cup green peppers",
"quantity": 0.5,
"measure": "cup",
"food": "green peppers",
"weight": 74.5,
"foodCategory": "vegetables",
"image": "https://www.edamam.com/food-img/629/629dc9fddc1f8aec27fa337dd6ce2b7c.jpg"
},
{
"text": "1 large green chilli",
"quantity": 1,
"measure": "",
"food": "green chilli",
"weight": 56.25,
"foodCategory": "vegetables",
"image": "https://www.edamam.com/food-img/73f/73ff2eeb21372fe15b0ec51f9ecf368d.jpeg"
},
{
"text": "1 cup of water",
"quantity": 1,
"measure": "cup",
"food": "water",
"weight": 236.5882365,
"foodCategory": "water",
"image": "https://www.edamam.com/food-img/5dd/5dd9d1361847b2ca53c4b19a8f92627e.jpg"
},
{
"text": "1 teaspoon of vegetable oil",
"quantity": 1,
"measure": "teaspoon",
"food": "vegetable oil",
"weight": 4.666666666982264,
"foodCategory": "Oils",
"image": "https://www.edamam.com/food-img/6e5/6e51a63a6300a8ea1b4c4cc68dfaba33.jpg"
},
{
"text": "a lime",
"quantity": 1,
"measure": "",
"food": "lime",
"weight": 67,
"foodCategory": "fruit",
"image": "https://www.edamam.com/food-img/48a/48a123c9576647c4ada6a41df5eeb22a.jpg"
}
],
"calories": 755.9033333361232,
"totalWeight": 758.0049031669822,
"totalTime": 0,
"cuisineType": [
"mediterranean"
],
"mealType": [
"lunch/dinner"
],
"dishType": [
"salad"
],
"totalNutrients": {
"ENERC_KCAL": {
"label": "Energy",
"quantity": 755.9033333361232,
"unit": "kcal"
},
"FAT": {
"label": "Fat",
"quantity": 7.276416666982264,
"unit": "g"
},
"FASAT": {
"label": "Saturated",
"quantity": 0.7473225000205455,
"unit": "g"
},
"FATRN": {
"label": "Trans",
"quantity": 0.03579333333575397,
"unit": "g"
},
"FAMS": {
"label": "Monounsaturated",
"quantity": 3.62748750022723,
"unit": "g"
},
"FAPU": {
"label": "Polyunsaturated",
"quantity": 1.8245925000539673,
"unit": "g"
},
"CHOCDF": {
"label": "Carbs",
"quantity": 149.27524999999997,
"unit": "g"
},
"CHOCDF.net": {
"label": "Carbohydrates (net)",
"quantity": 134.70199999999997,
"unit": "g"
},
"FIBTG": {
"label": "Fiber",
"quantity": 14.57325,
"unit": "g"
},
"SUGAR": {
"label": "Sugars",
"quantity": 10.227450000000001,
"unit": "g"
},
"PROCNT": {
"label": "Protein",
"quantity": 26.577199999999998,
"unit": "g"
},
"CHOLE": {
"label": "Cholesterol",
"quantity": 0,
"unit": "mg"
},
"NA": {
"label": "Sodium",
"quantity": 90.76602946,
"unit": "mg"
},
"CA": {
"label": "Calcium",
"quantity": 138.072647095,
"unit": "mg"
},
"MG": {
"label": "Magnesium",
"quantity": 132.818382365,
"unit": "mg"
},
"K": {
"label": "Potassium",
"quantity": 1183.345,
"unit": "mg"
},
"FE": {
"label": "Iron",
"quantity": 4.231699999999999,
"unit": "mg"
},
"ZN": {
"label": "Zinc",
"quantity": 2.63595882365,
"unit": "mg"
},
"P": {
"label": "Phosphorus",
"quantity": 361.365,
"unit": "mg"
},
"VITA_RAE": {
"label": "Vitamin A",
"quantity": 585.4975,
"unit": "µg"
},
"VITC": {
"label": "Vitamin C",
"quantity": 300.291,
"unit": "mg"
},
"THIA": {
"label": "Thiamin (B1)",
"quantity": 0.68566,
"unit": "mg"
},
"RIBF": {
"label": "Riboflavin (B2)",
"quantity": 0.360335,
"unit": "mg"
},
"NIA": {
"label": "Niacin (B3)",
"quantity": 7.734795,
"unit": "mg"
},
"VITB6A": {
"label": "Vitamin B6",
"quantity": 0.7675050000000001,
"unit": "mg"
},
"FOLDFE": {
"label": "Folate equivalent (total)",
"quantity": 214.9075,
"unit": "µg"
},
"FOLFD": {
"label": "Folate (food)",
"quantity": 214.9075,
"unit": "µg"
},
"FOLAC": {
"label": "Folic acid",
"quantity": 0,
"unit": "µg"
},
"VITB12": {
"label": "Vitamin B12",
"quantity": 0,
"unit": "µg"
},
"VITD": {
"label": "Vitamin D",
"quantity": 0,
"unit": "µg"
},
"TOCPHA": {
"label": "Vitamin E",
"quantity": 2.9409083334021338,
"unit": "mg"
},
"VITK1": {
"label": "Vitamin K",
"quantity": 114.83075000000002,
"unit": "µg"
},
"WATER": {
"label": "Water",
"quantity": 571.1343982635001,
"unit": "g"
}
},
"totalDaily": {
"ENERC_KCAL": {
"label": "Energy",
"quantity": 37.79516666680616,
"unit": "%"
},
"FAT": {
"label": "Fat",
"quantity": 11.194487179972715,
"unit": "%"
},
"FASAT": {
"label": "Saturated",
"quantity": 3.7366125001027273,
"unit": "%"
},
"CHOCDF": {
"label": "Carbs",
"quantity": 49.75841666666666,
"unit": "%"
},
"FIBTG": {
"label": "Fiber",
"quantity": 58.293,
"unit": "%"
},
"PROCNT": {
"label": "Protein",
"quantity": 53.154399999999995,
"unit": "%"
},
"CHOLE": {
"label": "Cholesterol",
"quantity": 0,
"unit": "%"
},
"NA": {
"label": "Sodium",
"quantity": 3.7819178941666665,
"unit": "%"
},
"CA": {
"label": "Calcium",
"quantity": 13.807264709500002,
"unit": "%"
},
"MG": {
"label": "Magnesium",
"quantity": 31.62342437261905,
"unit": "%"
},
"K": {
"label": "Potassium",
"quantity": 25.177553191489363,
"unit": "%"
},
"FE": {
"label": "Iron",
"quantity": 23.50944444444444,
"unit": "%"
},
"ZN": {
"label": "Zinc",
"quantity": 23.963262033181817,
"unit": "%"
},
"P": {
"label": "Phosphorus",
"quantity": 51.62357142857143,
"unit": "%"
},
"VITA_RAE": {
"label": "Vitamin A",
"quantity": 65.05527777777777,
"unit": "%"
},
"VITC": {
"label": "Vitamin C",
"quantity": 333.65666666666664,
"unit": "%"
},
"THIA": {
"label": "Thiamin (B1)",
"quantity": 57.138333333333335,
"unit": "%"
},
"RIBF": {
"label": "Riboflavin (B2)",
"quantity": 27.718076923076925,
"unit": "%"
},
"NIA": {
"label": "Niacin (B3)",
"quantity": 48.34246875,
"unit": "%"
},
"VITB6A": {
"label": "Vitamin B6",
"quantity": 59.038846153846166,
"unit": "%"
},
"FOLDFE": {
"label": "Folate equivalent (total)",
"quantity": 53.726875,
"unit": "%"
},
"VITB12": {
"label": "Vitamin B12",
"quantity": 0,
"unit": "%"
},
"VITD": {
"label": "Vitamin D",
"quantity": 0,
"unit": "%"
},
"TOCPHA": {
"label": "Vitamin E",
"quantity": 19.606055556014223,
"unit": "%"
},
"VITK1": {
"label": "Vitamin K",
"quantity": 95.69229166666669,
"unit": "%"
}
},
"digest": [
{
"label": "Fat",
"tag": "FAT",
"schemaOrgTag": "fatContent",
"total": 7.276416666982264,
"hasRDI": true,
"daily": 11.194487179972715,
"unit": "g",
"sub": [
{
"label": "Saturated",
"tag": "FASAT",
"schemaOrgTag": "saturatedFatContent",
"total": 0.7473225000205455,
"hasRDI": true,
"daily": 3.7366125001027273,
"unit": "g"
},
{
"label": "Trans",
"tag": "FATRN",
"schemaOrgTag": "transFatContent",
"total": 0.03579333333575397,
"hasRDI": false,
"daily": 0,
"unit": "g"
},
{
"label": "Monounsaturated",
"tag": "FAMS",
"schemaOrgTag": null,
"total": 3.62748750022723,
"hasRDI": false,
"daily": 0,
"unit": "g"
},
{
"label": "Polyunsaturated",
"tag": "FAPU",
"schemaOrgTag": null,
"total": 1.8245925000539673,
"hasRDI": false,
"daily": 0,
"unit": "g"
}
]
```
### Error Handling
`402`
In case of an error, the API will respond with an appropriate HTTP status code and an error message in the response body.
```
{
message: "param required for keyword based recipe fetch"
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://santech.gitbook.io/docs/recipe-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.