The APIs
EDAMAM (Recipe Search and Nutrition Analysis) and Youtube. These APIs are helpful for collecting popular and relevant recipes and exercise videos that are specific to the user’s criteria. We can leverage the API to examine very specific attributes and criteria of the nutrition of the recipe and the information available about the videos.
Link to EDAMAM: https://www.edamam.com/
Link to Youtube API: https://developers.google.com/youtube/v3
WHO
EDAMAM’s APIs are mainly about the recipes and its nutritional values. Here we are using EDAMAM’s Recipe Search API and EDAMAM Nutrition Analysis API.
The Recipe Search API sampled over 2 million recipes and continuously adds onto the recipe database from top recipes and cooking websites that are found on the web. The recipes are only from English and Spanish/Latin-American cooking websites. Unpopular recipes (meaning, for example, the recipe may have low web traffic) and recipes in other languages are under-sampled in EDAMAM. However, many people translate foreign recipes into English, so that is not a problem. Additionally, our app targets young college students and professionals in the United States who are already familiar with English, so that is not a problem.
The Nutrition Analysis API uses anything from the EDAMAM recipe database or user-inputted recipes as input and analyses them for nutrition by whole recipe or individual ingredient. The API can also label the input data with Low-Sodium, Vegan, and such. The nutrition analysis may be limited by the languages the API can process as well as the breadth of the food database it uses to evaluate the nutrition for the ingredients; for example, in EDAMAM, very rare ingredients in English-translated recipes may not have nutrition analysis data. Our target group is filled with people who lead busy lives that will not allow them time to hunt down esoteric and expensive ingredients, this is not a big limitation.
The Youtube API provides access to the billions of videos from around the world, among which are millions of exercise videos. You can search for exercise videos as you do on Youtube, but you can search and sort by many more elements of information that are available through the website’s search bar. Given the range of videos on Youtube, the only under-sampled exercise videos would be those exercise videos that are restricted by private companies/businesses to purchasing customers or to customers that visit the company’s website. However, the most popular and relevant exercises from any part of the world are likely to be on Youtube because people like to share these activities.
For Both: The personal information that could possibly be revealed through these APIs is the personal information that, tangentially to the API, the recipe makers (for EDAMAM) or the video makers (for Youtube) make available themselves. EDAMAM links back to the websites that source the recipe (and others by the creator and possibly their blog) and the Youtube video contents/associated channel full of other videos may also contain personal or identifying information that the creator reveals themselves. Both EDAMAM and Youtube do not provide ready-to-use analytics resources for mining the recipe or video data to further identify the creators through their works.
WHAT
Variables Related to User Story: Recipe Search API
The API data allows the user to filter recipes by various factors like health, excluded, and nutrients that will allow them to restrict recipes to the ones that meet their health needs. There are also other variables that can be used to meet the user’s time/schedule and food type preferences.
WHEN-Related: ingr, time, mealType
WHERE-Related: cuisineType, source, foodCategory
WHY-Related: dietLabbels, health, calories, excluded, nutrients[NTR code], dishType
Detail of the variables (to search/filter for recipes by)
ingr: number of ingredients
time: the range (min to max) of the total prep and cooking time
mealType: label of breakfast, lunch, dinner or snack
cuisineType: the type of food according to global origin like Mexican or Japanese
source: the main site that the recipe is from
foodCategory: what aisle or which part of the store you can find the food in
diet: labels to apply general health restrictions to food that are related to common healthy diets like low-sugar and high-fiber
health: labels to apply general health restrictions to food like low-cholesterol or gluten-free
calories: range of calories for the recipe
excluded: certain ingredients you do not want in the recipe
nutrients[NTR code]: used to specify the value range of various nutrients to be gained from recipe
dishType: label of type of food by general category like salad or dessert
Variables Related to User Story: Nutrition Analysis API
The API data allows the user to determine in a detailed manner, if the recipe they will want to cook will meet their nutritional needs and their time needs. There are also other variables that can be used to meet the user’s food type preferences.
WHEN-Related: ingr[ ], ttime, mealtype
WHERE-Related: cuisine, url, summary
WHY-Related: dietLabels, healthLabels, calories, totalDaily, totalNutrients,
dishtype, nutrition-type
Detail of the variables (to search/filter/explore nutritional analysis)
ingr[ ]: list of ingredients
ttime: time it takes to prepare the inputted recipe
mealType: label of breakfast, lunch, dinner or snack
cuisine: the type of food according to global origin like Mexican or Japanese
source: the main site that the recipe is from
url: the site the recipe is from
summary: some brief information about the recipe
dietLabels: similar to above
healthLabels: similar to above
calories: calories in food
totalDaily: information about % of the daily nutrition that recipe makes up
totalNutrients: the total of the daily nutrition that recipe makes up
dishtype: similar to above
nutrition-type: gets nutrition information about a ingredient
Variables Related to User Story: Youtube API
The API data allows users to search for popular, relevant exercise videos from various parts of the world and from various time periods. Users can narrow down videos they want by going through variables like the category, description, and content details.
WHEN-Related: publishedAfter, publishedBefore, publishedAt
WHERE-Related: relevanceLanguage, regionCode
WHY-Related: q, videoCategoryId, contentDetails, description, title
Detail of the variables
For searching (Parameters)
publishedAfter and publishedBefore: Search videos before or after certain date.
regionCode: Each video has region restrictions. If the video is viewable in the region, it returns the list of the videos. Please refer to ISO 3166-1 alpha-2.
q: ‘q’ means query term. It shows the result that is related to the input text.
relevanceLanguage: It cares about the language type of query. Please refer to ISO 639-1 two-letter language code.
videoCategoryId: Search video by certain category (e.g. sports or games).
Each video has… (Properties)
publishedAt: The date when the video uploaded.
categoryId: The category ID of the video. It is in a snippet object.
contentDetails: It is an object that has the detail of the video such as lengths, rating, region restriction, and so on.
description: The description of the video. It is in a snippet object.
title: The title of the video. It is in a snippet object.
WHEN
All the APIs have data that is kept up-to-date or produced/updated in real-time. The YouTube API has an attribute which is the date when they are created or uploaded, which you can search by. The nutrient analysis is performed using data (ex:- about how recipe steps affect final nutrient content of food) that is updated based on new findings. There are also ingredient lists, ingredient counts, preparation times, and meal type (ex:- dinner) for EDAMAM APIs that you can filter by in order to make it suit the user’s time needs and schedule. Users will be benefited by going easier with their daily food menu planning along with their shopping while maintaining a healthy lifestyle. Not only healthy food but also some exercises are essential for managing their healthy lives.
WHERE
The data for the APIs is collected globally from the web or world-wide creators on the web. For the EDAMAM APIs, there is no attribute mentioning a certain place. It is just recipes’ cuisine AKA recipe region or origin types, where the food is located in store by category, and the url of the source website (plus summary information derived from recipe). People can cook anything any place as long as they can get ingredients. They can search by local or foreign ingredients for recipes. YouTube API has some attributes indicating what regions of the world the video is available in or related to. People can watch and do some exercise wherever they want.
WHY
Why EDAMAM Recipe API?
In this API we can search for a recipe accordingly with their nutrient range (ex:- we can specify that we need a recipe with fat less than 50 calories)
We can get the recipes as per our interest that is we can get the recipes by removing some of the ingredients which we don’t like (ex:-If a person does not eat pork, he may get the recipe list without pork as an ingredient)
We can also get recipes according to our diet and health labels line low fat, high fiber, high protein etc.
Edamam API has also introduced 35 diet and health filters for the customers to use when they are searching for a recipe.
We can also get the time for preparation, which will help our busy users with their scheduling and time management.
Why EDAMAM Nutrition Analysis API?
In this API we can input the whole text of the recipe or the list of ingredients and we can get its nutritional values in less than a second. Inputting recipes also does nutritional analysis for how it is prepared.
For each food item (flour, eggs, flour etc.), the API provides the nutritional data in calories, calcium, fats, carbohydrates, Iron, protein, magnesium, cholesterol, sodium etc.
Why YouTube API?
In this API we can give some phrases of exercise as input then it lists some of the most popular related videos.
I suppose YouTube is the one of the biggest social media that treats a video and live streaming. The users are likely to find the most significant video easily.
YouTube is world wide social media, so there are not big language barriers since they can find the video in their favorite languages. For example, if they type texts in Japanese in the search bar, the result would be Japanese videos.
A busy user from our target group can find the most popular exercise videos from around the world that you can do at home, by yourself, or according to other limitations you have quickly and easily.
REFERENCES
Upload / share your folder with ocela.ai@gmail.com with images for all classes.
Add an image for each class as an example.
Reference: EduKC
Open the following Google Drive folder (which only your team has access to) and upload the data for your project.