fatsecret Platform API Documentation
Image Recognition
Description
This API detects foods within an image and returns a list of foods from the fatsecret database
By passing a list of eaten foods, we will also attempt to determine if any of the inputs match in order to improve the accuracy of the response.
NOTE: If an appropriate serving is not found, nutritional information may not be present. This will typically occur for a non-standard serving description provided for a restaurant based food.
Parameters
URL / Method
| NAME | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
| URL (new) Method |
N/A | Required | "https://platform.fatsecret.com/rest/image-recognition/v1" HTTP "POST" |
Example Request:
{
"image_b64": "{Base64 encoded image string}",
"region": "US",
"language": "en",
"include_food_data": true,
"eaten_foods": [
{
"food_id": 3092,
"food_name": "egg",
"brand": null,
"serving_description": "whole",
"serving_size": 1
}
]
}Json Property Descriptions
| NAME | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
| image_b64 | String | Required | A Base64 image of one or more foods. This field is limited to 1148549 characters |
| include_food_data | Bool | Optional | Include food data in the response (see our food.get API) |
| eaten_foods | Array | Optional | An array of previously consumed foods |
| eaten_foods.food_id | Long | Required | The ID of the food that has been previously consumed |
| eaten_foods.food_name | String | Required | The name of the food that has been previously consumed |
| eaten_foods.food_brand | String | Optional | The brand name of the food that has been previously consumed |
| eaten_foods.serving_description | String | Optional | The serving description of the food that has been previously consumed |
| eaten_foods.serving_size | String | Optional | The serving size of the food that has been previously consumed |
| region | String | Optional | Results will be filtered by region. E.G.: "FR" returns results from France |
| language | String | Optional | (Ignored unless region is also specified) Results will be in the specified language. E.G.: "fr" returns results in French |
Response
Each food_response element contains information as follows:
| NAME | TYPE | DESCRIPTION |
|---|---|---|
| food_id | Long | Unique food identifier |
| food_entry_name | String | A description of the food item as entered by the user; typically the name of the food. E.G.: "Instant Oatmeal" |
| brand_name | String | Brand name, only when food_type is "Brand". E.G.: "Quaker" |
Each eaten element contains information as follows:
| NAME | TYPE | DESCRIPTION |
|---|---|---|
| singular_description | String | Description of a single portion |
| plural_description | String | Description of a plural portion |
| units | Decimal | Number of units eaten |
| metric_description | String | Metric description of eaten food |
| total_metric_amount | Decimal | Total metric amount of eaten food |
| per_unit_metric_amount | Decimal | Metric amount per portion of eaten food |
Each total_nutritional_content element contains information as follows:
| NAME | TYPE | DESCRIPTION |
|---|---|---|
| calories | Decimal | Total energy content in kcal |
| carbohydrate | Decimal | Total carbohydrate content in grams |
| protein | Decimal | Total protein content in grams |
| fat | Decimal | Total fat content in grams |
| saturated_fat | Decimal | Total saturated fat content in grams (where available) |
| polyunsaturated_fat | Decimal | Total polyunsaturated fat content in grams (where available) |
| monounsaturated_fat | Decimal | Total monounsaturated fat content in grams (where available) |
| cholesterol | Decimal | Total cholesterol content in milligrams (where available) |
| sodium | Decimal | Total sodium content in milligrams (where available) |
| potassium | Decimal | Total potassium content in milligrams (where available) |
| fiber | Decimal | Total fiber content in grams (where available) |
| sugar | Decimal | Total sugar content in grams (where available) |
| vitamin_a | Decimal | Total vitamin A content in micrograms (where available) |
| vitamin_c | Decimal | Total vitamin C content in milligrams (where available) |
| calcium | Decimal | Total calcium content in milligrams (where available) |
| iron | Decimal | Total iron content in milligrams (where available) |
| trans_fat | Decimal | Total trans fat content in grams (where available) |
| vitamin_d | Decimal | Total vitamin D content in micrograms (where available) |
Each suggested_serving element contains information as follows:
| NAME | TYPE | DESCRIPTION |
|---|---|---|
| serving_id | Long | Unique serving identifier |
| serving_description | String | Full description of the serving size. E.G.: "1 cup" or "100 g" |
| metric_serving_description | String | Metric description of suggested serving |
| metric_measure_amount | Decimal | Metric amount per portion of suggested serving |
| number_of_units | Decimal | Number of units in this standard serving size. For instance, if the serving description is "2 tablespoons" the number of units is "2", while if the serving size is "1 cup" the number of units is "1". Please note that this is only applicable for when food_type is "Generic" whereas for "Brand" the number of units will always be "1" |
Each food element contains information as follows:
| NAME | TYPE | DESCRIPTION |
|---|---|---|
| food_id | Long | Unique food identifier |
| food_name | String | Name of the food, not including the brand name. E.G.: "Instant Oatmeal" |
| food_type | String | Takes the value "Brand" or "Generic". Indicates whether the food is a brand or generic item |
| food_url | String | URL of this food item on www.fatsecret.com |
| brand_name | String | Brand name, only when food_type is "Brand". E.G.: "Quaker" |
Each serving element contains information as follows:
| NAME | TYPE | DESCRIPTION |
|---|---|---|
| serving_id | Long | Unique serving identifier |
| serving_description | String | Full description of the serving size. E.G.: "1 cup" or "100 g" |
| serving_url | String | URL of the serving size for this food item on www.fatsecret.com |
| metric_serving_amount | Decimal | Metric quantity combined with metric_serving_unit to derive the total standardized quantity of the serving (where available) |
| metric_serving_unit | String | Metric unit of measure for the serving size – either "g" or "ml" or "oz" – combined with metric_serving_amount to derive the total standardized quantity of the serving (where available) |
| is_default | Int | (Premier Exclusive) Only included if its the suggested or most commonly chosen option. If included equals 1 |
| number_of_units | Decimal | Number of units in this standard serving size. For instance, if the serving description is "2 tablespoons" the number of units is "2", while if the serving size is "1 cup" the number of units is "1". Please note that this is only applicable for when food_type is "Generic" whereas for "Brand" the number of units will always be "1" |
| measurement_description | String | A description of the unit of measure used in the serving description. For instance, if the description is "1/2 cup" the measurement description is "cup", while if the serving size is "100 g" the measurement description is "g". Please note that this is only applicable for when food_type is "Generic" whereas for "Brand" the measurement description will always be "serving" |
| calories | Decimal | Total energy content in kcal |
| carbohydrate | Decimal | Total carbohydrate content in grams |
| protein | Decimal | Total protein content in grams |
| fat | Decimal | Total fat content in grams |
| saturated_fat | Decimal | Total saturated fat content in grams (where available) |
| polyunsaturated_fat | Decimal | Total polyunsaturated fat content in grams (where available) |
| monounsaturated_fat | Decimal | Total monounsaturated fat content in grams (where available) |
| cholesterol | Decimal | Total cholesterol content in milligrams (where available) |
| sodium | Decimal | Total sodium content in milligrams (where available) |
| potassium | Decimal | Total potassium content in milligrams (where available) |
| fiber | Decimal | Total fiber content in grams (where available) |
| sugar | Decimal | Total sugar content in grams (where available) |
| vitamin_a | Decimal | Total vitamin A content in micrograms (where available) |
| vitamin_c | Decimal | Total vitamin C content in milligrams (where available) |
| calcium | Decimal | Total calcium content in milligrams (where available) |
| iron | Decimal | Total iron content in milligrams (where available) |
| trans_fat | Decimal | Total trans fat content in grams (where available) |
| vitamin_d | Decimal | Total vitamin D content in micrograms (where available) |
Example Response
Example 1:
{
"food_response": [
{
"food_id": 38821,
"food_entry_name": "Toasted White Bread",
"eaten": {
"singular_description": "",
"plural_description": "",
"units": 1.0,
"metric_description": "g",
"total_metric_amount": 28.0,
"per_unit_metric_amount": 28,
"total_nutritional_content": {
"calories": "82",
"carbohydrate": "15.23",
"protein": "2.52",
"fat": "1.12",
"saturated_fat": "0.162",
"polyunsaturated_fat": "0.585",
"monounsaturated_fat": "0.223",
"cholesterol": "0",
"sodium": "166",
"potassium": "37",
"fiber": "0.7",
"sugar": "1.33",
"vitamin_a": "0",
"vitamin_c": "0",
"calcium": "33",
"iron": "0.93"
}
},
"suggested_serving": {
"serving_id": 38646,
"serving_description": "1 slice",
"metric_serving_description": "g",
"metric_measure_amount": 22.000,
"number_of_units": "1.273"
}
},
{
"food_id": 5388,
"food_entry_name": "Banana",
"eaten": {
"singular_description": "",
"plural_description": "",
"units": 1.0,
"metric_description": "g",
"total_metric_amount": 118.0,
"per_unit_metric_amount": 118,
"total_nutritional_content": {
"calories": "105",
"carbohydrate": "26.95",
"protein": "1.29",
"fat": "0.39",
"saturated_fat": "0.132",
"polyunsaturated_fat": "0.086",
"monounsaturated_fat": "0.038",
"cholesterol": "0",
"sodium": "1",
"potassium": "422",
"fiber": "3.1",
"sugar": "14.43",
"vitamin_a": "4",
"vitamin_c": "10.3",
"calcium": "6",
"iron": "0.31"
}
},
"suggested_serving": {
"serving_id": 19134,
"serving_description": "1 medium (7\" to 7-7/8\" long)",
"metric_serving_description": "g",
"metric_measure_amount": 118.000,
"number_of_units": "1"
}
},
{
"food_id": 44911664,
"food_entry_name": "Apple",
"brand_name": "Cosmic Crisp",
"eaten": {
"singular_description": "",
"plural_description": "",
"units": 1.0,
"metric_description": "g",
"total_metric_amount": 182.0,
"per_unit_metric_amount": 182,
"total_nutritional_content": {
"calories": "130",
"carbohydrate": "31.20",
"protein": "0.00",
"fat": "0.65",
"saturated_fat": "0.000",
"added_sugar": "0.000",
"trans_fat": "0.000",
"cholesterol": "0",
"sodium": "0",
"potassium": "156",
"fiber": "7.8",
"sugar": "19.50",
"vitamin_d": "0",
"calcium": "0",
"iron": "0.39"
}
},
"suggested_serving": {
"serving_id": 38715860,
"serving_description": "1 apple",
"metric_serving_description": "g",
"metric_measure_amount": 140.000,
"number_of_units": "1.30"
}
},
{
"food_id": 1240,
"food_entry_name": "Cheese",
"eaten": {
"singular_description": "",
"plural_description": "",
"units": 1.0,
"metric_description": "g",
"total_metric_amount": 28.0,
"per_unit_metric_amount": 28,
"total_nutritional_content": {
"calories": "98",
"carbohydrate": "1.32",
"protein": "6.22",
"fat": "7.53",
"saturated_fat": "4.651",
"polyunsaturated_fat": "0.268",
"monounsaturated_fat": "2.146",
"cholesterol": "23",
"sodium": "267",
"potassium": "52",
"fiber": "0",
"sugar": "0.99",
"vitamin_a": "59",
"vitamin_c": "0",
"calcium": "182",
"iron": "0.14"
}
},
"suggested_serving": {
"serving_id": 2074,
"serving_description": "1 slice",
"metric_serving_description": "g",
"metric_measure_amount": 24.000,
"number_of_units": "1.167"
}
},
{
"food_id": 35144,
"food_entry_name": "Sliced Ham (Regular, Approx. 11% Fat)",
"eaten": {
"singular_description": "",
"plural_description": "",
"units": 1.0,
"metric_description": "g",
"total_metric_amount": 28.0,
"per_unit_metric_amount": 28,
"total_nutritional_content": {
"calories": "46",
"carbohydrate": "1.07",
"protein": "4.65",
"fat": "2.41",
"saturated_fat": "0.822",
"polyunsaturated_fat": "0.221",
"monounsaturated_fat": "1.219",
"cholesterol": "16",
"sodium": "365",
"potassium": "80",
"fiber": "0.4",
"sugar": "0.00",
"vitamin_a": "0",
"vitamin_c": "1.1",
"calcium": "7",
"iron": "0.29"
}
},
"suggested_serving": {
"serving_id": 32249,
"serving_description": "1 slice",
"metric_serving_description": "g",
"metric_measure_amount": 28.000,
"number_of_units": "1"
}
},
{
"food_id": 7350,
"food_entry_name": "Cappuccino",
"eaten": {
"singular_description": "",
"plural_description": "",
"units": 1.0,
"total_metric_amount": 240,
"per_unit_metric_amount": 240,
"total_nutritional_content": {
"calories": "74",
"carbohydrate": "5.81",
"protein": "4.08",
"fat": "3.98",
"saturated_fat": "2.273",
"polyunsaturated_fat": "0.241",
"monounsaturated_fat": "1.007",
"cholesterol": "12",
"sodium": "50",
"potassium": "233",
"fiber": "0.2",
"sugar": "6.41",
"vitamin_a": "34",
"vitamin_c": "0.0",
"calcium": "144",
"iron": "0.19"
}
},
"suggested_serving": {
"serving_id": 28300,
"serving_description": "1 mug (8 fl oz)",
"metric_measure_amount": 240.000,
"number_of_units": "1"
}
}
]
}Example 2:
{
"food_response": [
{
"food_id": 38821,
"food_entry_name": "Toasted White Bread",
"eaten": {
"singular_description": "",
"plural_description": "",
"units": 1.0,
"metric_description": "g",
"total_metric_amount": 28.0,
"per_unit_metric_amount": 28,
"total_nutritional_content": {
"calories": "82",
"carbohydrate": "15.23",
"protein": "2.52",
"fat": "1.12",
"saturated_fat": "0.162",
"polyunsaturated_fat": "0.585",
"monounsaturated_fat": "0.223",
"cholesterol": "0",
"sodium": "166",
"potassium": "37",
"fiber": "0.7",
"sugar": "1.33",
"vitamin_a": "0",
"vitamin_c": "0",
"calcium": "33",
"iron": "0.93"
}
},
"suggested_serving": {
"serving_id": 38646,
"serving_description": "1 slice",
"metric_serving_description": "g",
"metric_measure_amount": 22.000,
"number_of_units": "1.273"
},
"food": {
"food_id": "38821",
"food_name": "Toasted White Bread",
"food_type": "Generic",
"food_url": "https://www.fatsecret.com/calories-nutrition/usda/toasted-white-bread",
"servings": {
"serving": [
{
"serving_id": "38646",
"serving_description": "1 slice",
"serving_url": "https://www.fatsecret.com/calories-nutrition/usda/toasted-white-bread?portionid=38646&portionamount=1.000",
"metric_serving_amount": "22.000",
"metric_serving_unit": "g",
"is_default": true,
"number_of_units": "1.000",
"measurement_description": "slice",
"calories": "64",
"carbohydrate": "11.97",
"protein": "1.98",
"fat": "0.88",
"saturated_fat": "0.127",
"polyunsaturated_fat": "0.460",
"monounsaturated_fat": "0.175",
"cholesterol": "0",
"sodium": "130",
"potassium": "29",
"fiber": "0.6",
"sugar": "1.04",
"vitamin_a": "0",
"vitamin_c": "0.0",
"calcium": "26",
"iron": "0.73"
},
{
"serving_id": "61552",
"serving_description": "100 g",
"serving_url": "https://www.fatsecret.com/calories-nutrition/usda/toasted-white-bread?portionid=61552&portionamount=100.000",
"metric_serving_amount": "100.000",
"metric_serving_unit": "g",
"number_of_units": "100.000",
"measurement_description": "g",
"calories": "293",
"carbohydrate": "54.40",
"protein": "9.00",
"fat": "4.00",
"saturated_fat": "0.578",
"polyunsaturated_fat": "2.090",
"monounsaturated_fat": "0.796",
"cholesterol": "1",
"sodium": "592",
"potassium": "131",
"fiber": "2.5",
"sugar": "4.74",
"vitamin_a": "0",
"vitamin_c": "0.0",
"calcium": "119",
"iron": "3.33"
},
{
"serving_id": "38641",
"serving_description": "1 slice large",
"serving_url": "https://www.fatsecret.com/calories-nutrition/usda/toasted-white-bread?portionid=38641&portionamount=1.000",
"metric_serving_amount": "27.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "slice, large",
"calories": "79",
"carbohydrate": "14.69",
"protein": "2.43",
"fat": "1.08",
"saturated_fat": "0.156",
"polyunsaturated_fat": "0.564",
"monounsaturated_fat": "0.215",
"cholesterol": "0",
"sodium": "160",
"potassium": "35",
"fiber": "0.7",
"sugar": "1.28",
"vitamin_a": "0",
"vitamin_c": "0.0",
"calcium": "32",
"iron": "0.90"
},
{
"serving_id": "38643",
"serving_description": "1 slice, thin",
"serving_url": "https://www.fatsecret.com/calories-nutrition/usda/toasted-white-bread?portionid=38643&portionamount=1.000",
"metric_serving_amount": "17.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "slice, thin",
"calories": "50",
"carbohydrate": "9.25",
"protein": "1.53",
"fat": "0.68",
"saturated_fat": "0.098",
"polyunsaturated_fat": "0.355",
"monounsaturated_fat": "0.135",
"cholesterol": "0",
"sodium": "101",
"potassium": "22",
"fiber": "0.4",
"sugar": "0.81",
"vitamin_a": "0",
"vitamin_c": "0.0",
"calcium": "20",
"iron": "0.57"
}
]
}
}
},
{
"food_id": 5388,
"food_entry_name": "Banana",
"eaten": {
"singular_description": "",
"plural_description": "",
"units": 1.0,
"metric_description": "g",
"total_metric_amount": 118.0,
"per_unit_metric_amount": 118,
"total_nutritional_content": {
"calories": "105",
"carbohydrate": "26.95",
"protein": "1.29",
"fat": "0.39",
"saturated_fat": "0.132",
"polyunsaturated_fat": "0.086",
"monounsaturated_fat": "0.038",
"cholesterol": "0",
"sodium": "1",
"potassium": "422",
"fiber": "3.1",
"sugar": "14.43",
"vitamin_a": "4",
"vitamin_c": "10.3",
"calcium": "6",
"iron": "0.31"
}
},
"suggested_serving": {
"serving_id": 19134,
"serving_description": "1 medium (7\" to 7-7/8\" long)",
"metric_serving_description": "g",
"metric_measure_amount": 118.000,
"number_of_units": "1"
},
"food": {
"food_id": "5388",
"food_name": "Banana",
"food_type": "Generic",
"food_url": "https://www.fatsecret.com/calories-nutrition/generic/banana-raw",
"servings": {
"serving": [
{
"serving_id": "19134",
"serving_description": "1 medium (7\" to 7-7/8\" long)",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/banana-raw?portionid=19134&portionamount=1.000",
"metric_serving_amount": "118.000",
"metric_serving_unit": "g",
"is_default": true,
"number_of_units": "1.000",
"measurement_description": "medium (7\" to 7-7/8\" long)",
"calories": "105",
"carbohydrate": "26.95",
"protein": "1.29",
"fat": "0.39",
"saturated_fat": "0.132",
"polyunsaturated_fat": "0.086",
"monounsaturated_fat": "0.038",
"cholesterol": "0",
"sodium": "1",
"potassium": "422",
"fiber": "3.1",
"sugar": "14.43",
"vitamin_a": "4",
"vitamin_c": "10.3",
"calcium": "6",
"iron": "0.31"
},
{
"serving_id": "54068",
"serving_description": "100 g",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/banana-raw?portionid=54068&portionamount=100.000",
"metric_serving_amount": "100.000",
"metric_serving_unit": "g",
"number_of_units": "100.000",
"measurement_description": "g",
"calories": "89",
"carbohydrate": "22.84",
"protein": "1.09",
"fat": "0.33",
"saturated_fat": "0.112",
"polyunsaturated_fat": "0.073",
"monounsaturated_fat": "0.032",
"cholesterol": "0",
"sodium": "1",
"potassium": "358",
"fiber": "2.6",
"sugar": "12.23",
"vitamin_a": "3",
"vitamin_c": "8.7",
"calcium": "5",
"iron": "0.26"
},
{
"serving_id": "17684",
"serving_description": "1 small (6\" to 6-7/8\" long)",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/banana-raw?portionid=17684&portionamount=1.000",
"metric_serving_amount": "101.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "small (6\" to 6-7/8\" long)",
"calories": "90",
"carbohydrate": "23.07",
"protein": "1.10",
"fat": "0.33",
"saturated_fat": "0.113",
"polyunsaturated_fat": "0.074",
"monounsaturated_fat": "0.032",
"cholesterol": "0",
"sodium": "1",
"potassium": "362",
"fiber": "2.6",
"sugar": "12.35",
"vitamin_a": "3",
"vitamin_c": "8.8",
"calcium": "5",
"iron": "0.26"
},
{
"serving_id": "17685",
"serving_description": "1 large (8\" to 8-7/8\" long)",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/banana-raw?portionid=17685&portionamount=1.000",
"metric_serving_amount": "136.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "large (8\" to 8-7/8\" long)",
"calories": "121",
"carbohydrate": "31.06",
"protein": "1.48",
"fat": "0.45",
"saturated_fat": "0.152",
"polyunsaturated_fat": "0.099",
"monounsaturated_fat": "0.044",
"cholesterol": "0",
"sodium": "1",
"potassium": "487",
"fiber": "3.5",
"sugar": "16.63",
"vitamin_a": "4",
"vitamin_c": "11.8",
"calcium": "7",
"iron": "0.35"
},
{
"serving_id": "17793",
"serving_description": "1 extra small (less than 6\" long)",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/banana-raw?portionid=17793&portionamount=1.000",
"metric_serving_amount": "81.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "extra small (less than 6\" long)",
"calories": "72",
"carbohydrate": "18.50",
"protein": "0.88",
"fat": "0.27",
"saturated_fat": "0.091",
"polyunsaturated_fat": "0.059",
"monounsaturated_fat": "0.026",
"cholesterol": "0",
"sodium": "1",
"potassium": "290",
"fiber": "2.1",
"sugar": "9.91",
"vitamin_a": "2",
"vitamin_c": "7.0",
"calcium": "4",
"iron": "0.21"
},
{
"serving_id": "19614",
"serving_description": "1 serving (118 g)",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/banana-raw?portionid=19614&portionamount=1.000",
"metric_serving_amount": "118.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "serving (118g)",
"calories": "105",
"carbohydrate": "26.95",
"protein": "1.29",
"fat": "0.39",
"saturated_fat": "0.132",
"polyunsaturated_fat": "0.086",
"monounsaturated_fat": "0.038",
"cholesterol": "0",
"sodium": "1",
"potassium": "422",
"fiber": "3.1",
"sugar": "14.43",
"vitamin_a": "4",
"vitamin_c": "10.3",
"calcium": "6",
"iron": "0.31"
},
{
"serving_id": "17996",
"serving_description": "1 oz yields",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/banana-raw?portionid=17996&portionamount=1.000",
"metric_serving_amount": "18.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "oz yields",
"calories": "16",
"carbohydrate": "4.11",
"protein": "0.20",
"fat": "0.06",
"saturated_fat": "0.020",
"polyunsaturated_fat": "0.013",
"monounsaturated_fat": "0.006",
"cholesterol": "0",
"sodium": "0",
"potassium": "64",
"fiber": "0.5",
"sugar": "2.20",
"vitamin_a": "1",
"vitamin_c": "1.6",
"calcium": "1",
"iron": "0.05"
}
]
}
}
},
{
"food_id": 44911664,
"food_entry_name": "Apple",
"brand_name": "Cosmic Crisp",
"eaten": {
"singular_description": "",
"plural_description": "",
"units": 1.0,
"metric_description": "g",
"total_metric_amount": 182.0,
"per_unit_metric_amount": 182,
"total_nutritional_content": {
"calories": "130",
"carbohydrate": "31.20",
"protein": "0.00",
"fat": "0.65",
"saturated_fat": "0.000",
"added_sugar": "0.000",
"trans_fat": "0.000",
"cholesterol": "0",
"sodium": "0",
"potassium": "156",
"fiber": "7.8",
"sugar": "19.50",
"vitamin_d": "0",
"calcium": "0",
"iron": "0.39"
}
},
"suggested_serving": {
"serving_id": 38715860,
"serving_description": "1 apple",
"metric_serving_description": "g",
"metric_measure_amount": 140.000,
"number_of_units": "1.30"
},
"food": {
"food_id": "44911664",
"food_name": "Apple",
"brand_name": "Cosmic Crisp",
"food_type": "Brand",
"food_url": "https://www.fatsecret.com/calories-nutrition/cosmic-crisp/apple",
"servings": {
"serving": [
{
"serving_id": "38715860",
"serving_description": "1 apple",
"serving_url": "https://www.fatsecret.com/calories-nutrition/cosmic-crisp/apple",
"metric_serving_amount": "140.000",
"metric_serving_unit": "g",
"is_default": true,
"number_of_units": "1.000",
"measurement_description": "serving",
"calories": "100",
"carbohydrate": "24.00",
"protein": "0.00",
"fat": "0.50",
"saturated_fat": "0.000",
"added_sugar": "0.000",
"trans_fat": "0.000",
"cholesterol": "0",
"sodium": "0",
"potassium": "120",
"fiber": "6.0",
"sugar": "15.00",
"vitamin_d": "0",
"calcium": "0",
"iron": "0.30"
}
]
}
}
},
{
"food_id": 1240,
"food_entry_name": "Cheese",
"eaten": {
"singular_description": "",
"plural_description": "",
"units": 1.0,
"metric_description": "g",
"total_metric_amount": 28.0,
"per_unit_metric_amount": 28,
"total_nutritional_content": {
"calories": "98",
"carbohydrate": "1.32",
"protein": "6.22",
"fat": "7.53",
"saturated_fat": "4.651",
"polyunsaturated_fat": "0.268",
"monounsaturated_fat": "2.146",
"cholesterol": "23",
"sodium": "267",
"potassium": "52",
"fiber": "0",
"sugar": "0.99",
"vitamin_a": "59",
"vitamin_c": "0",
"calcium": "182",
"iron": "0.14"
}
},
"suggested_serving": {
"serving_id": 2074,
"serving_description": "1 slice",
"metric_serving_description": "g",
"metric_measure_amount": 24.000,
"number_of_units": "1.167"
},
"food": {
"food_id": "1240",
"food_name": "Cheese",
"food_type": "Generic",
"food_url": "https://www.fatsecret.com/calories-nutrition/generic/cheese",
"servings": {
"serving": [
{
"serving_id": "49920",
"serving_description": "100 g",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cheese?portionid=49920&portionamount=100.000",
"metric_serving_amount": "100.000",
"metric_serving_unit": "g",
"is_default": true,
"number_of_units": "100.000",
"measurement_description": "g",
"calories": "350",
"carbohydrate": "4.71",
"protein": "22.21",
"fat": "26.91",
"saturated_fat": "16.609",
"polyunsaturated_fat": "0.956",
"monounsaturated_fat": "7.664",
"cholesterol": "83",
"sodium": "955",
"potassium": "187",
"fiber": "0",
"sugar": "3.54",
"vitamin_a": "210",
"vitamin_c": "0.0",
"calcium": "651",
"iron": "0.51"
},
{
"serving_id": "2074",
"serving_description": "1 slice",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cheese?portionid=2074&portionamount=1.000",
"metric_serving_amount": "24.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "slice",
"calories": "84",
"carbohydrate": "1.13",
"protein": "5.33",
"fat": "6.46",
"saturated_fat": "3.986",
"polyunsaturated_fat": "0.229",
"monounsaturated_fat": "1.839",
"cholesterol": "20",
"sodium": "229",
"potassium": "45",
"fiber": "0",
"sugar": "0.85",
"vitamin_a": "50",
"vitamin_c": "0.0",
"calcium": "156",
"iron": "0.12"
},
{
"serving_id": "180460",
"serving_description": "1 oz",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cheese?portionid=180460&portionamount=1.000",
"metric_serving_amount": "28.350",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "oz",
"calories": "99",
"carbohydrate": "1.34",
"protein": "6.30",
"fat": "7.63",
"saturated_fat": "4.709",
"polyunsaturated_fat": "0.271",
"monounsaturated_fat": "2.173",
"cholesterol": "24",
"sodium": "271",
"potassium": "53",
"fiber": "0",
"sugar": "1.00",
"vitamin_a": "60",
"vitamin_c": "0.0",
"calcium": "185",
"iron": "0.14"
},
{
"serving_id": "2363",
"serving_description": "1 serving (24 g)",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cheese?portionid=2363&portionamount=1.000",
"metric_serving_amount": "24.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "serving (24g)",
"calories": "84",
"carbohydrate": "1.13",
"protein": "5.33",
"fat": "6.46",
"saturated_fat": "3.986",
"polyunsaturated_fat": "0.229",
"monounsaturated_fat": "1.839",
"cholesterol": "20",
"sodium": "229",
"potassium": "45",
"fiber": "0",
"sugar": "0.85",
"vitamin_a": "50",
"vitamin_c": "0.0",
"calcium": "156",
"iron": "0.12"
},
{
"serving_id": "2075",
"serving_description": "1 cubic inch",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cheese?portionid=2075&portionamount=1.000",
"metric_serving_amount": "17.300",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "cubic inch",
"calories": "61",
"carbohydrate": "0.81",
"protein": "3.84",
"fat": "4.66",
"saturated_fat": "2.873",
"polyunsaturated_fat": "0.165",
"monounsaturated_fat": "1.326",
"cholesterol": "14",
"sodium": "165",
"potassium": "32",
"fiber": "0",
"sugar": "0.61",
"vitamin_a": "36",
"vitamin_c": "0.0",
"calcium": "113",
"iron": "0.09"
}
]
}
}
},
{
"food_id": 35144,
"food_entry_name": "Sliced Ham (Regular, Approx. 11% Fat)",
"eaten": {
"singular_description": "",
"plural_description": "",
"units": 1.0,
"metric_description": "g",
"total_metric_amount": 28.0,
"per_unit_metric_amount": 28,
"total_nutritional_content": {
"calories": "46",
"carbohydrate": "1.07",
"protein": "4.65",
"fat": "2.41",
"saturated_fat": "0.822",
"polyunsaturated_fat": "0.221",
"monounsaturated_fat": "1.219",
"cholesterol": "16",
"sodium": "365",
"potassium": "80",
"fiber": "0.4",
"sugar": "0.00",
"vitamin_a": "0",
"vitamin_c": "1.1",
"calcium": "7",
"iron": "0.29"
}
},
"suggested_serving": {
"serving_id": 32249,
"serving_description": "1 slice",
"metric_serving_description": "g",
"metric_measure_amount": 28.000,
"number_of_units": "1"
},
"food": {
"food_id": "35144",
"food_name": "Sliced Ham (Regular, Approx. 11% Fat)",
"food_type": "Generic",
"food_url": "https://www.fatsecret.com/calories-nutrition/usda/sliced-ham--(regular-approx-11%25-fat)",
"servings": {
"serving": [
{
"serving_id": "32248",
"serving_description": "1 serving 2 slices",
"serving_url": "https://www.fatsecret.com/calories-nutrition/usda/sliced-ham--(regular-approx-11%25-fat)?portionid=32248&portionamount=1.000",
"metric_serving_amount": "56.000",
"metric_serving_unit": "g",
"is_default": true,
"number_of_units": "1.000",
"measurement_description": "serving 2 slices",
"calories": "91",
"carbohydrate": "2.14",
"protein": "9.30",
"fat": "4.82",
"saturated_fat": "1.644",
"polyunsaturated_fat": "0.442",
"monounsaturated_fat": "2.438",
"cholesterol": "32",
"sodium": "730",
"potassium": "161",
"fiber": "0.7",
"sugar": "0.00",
"vitamin_a": "0",
"vitamin_c": "2.2",
"calcium": "13",
"iron": "0.57"
},
{
"serving_id": "57875",
"serving_description": "100 g",
"serving_url": "https://www.fatsecret.com/calories-nutrition/usda/sliced-ham--(regular-approx-11%25-fat)?portionid=57875&portionamount=100.000",
"metric_serving_amount": "100.000",
"metric_serving_unit": "g",
"number_of_units": "100.000",
"measurement_description": "g",
"calories": "163",
"carbohydrate": "3.83",
"protein": "16.60",
"fat": "8.60",
"saturated_fat": "2.936",
"polyunsaturated_fat": "0.789",
"monounsaturated_fat": "4.354",
"cholesterol": "57",
"sodium": "1304",
"potassium": "287",
"fiber": "1.3",
"sugar": "0.00",
"vitamin_a": "0",
"vitamin_c": "4.0",
"calcium": "24",
"iron": "1.02"
},
{
"serving_id": "32249",
"serving_description": "1 slice",
"serving_url": "https://www.fatsecret.com/calories-nutrition/usda/sliced-ham--(regular-approx-11%25-fat)?portionid=32249&portionamount=1.000",
"metric_serving_amount": "28.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "slice",
"calories": "46",
"carbohydrate": "1.07",
"protein": "4.65",
"fat": "2.41",
"saturated_fat": "0.822",
"polyunsaturated_fat": "0.221",
"monounsaturated_fat": "1.219",
"cholesterol": "16",
"sodium": "365",
"potassium": "80",
"fiber": "0.4",
"sugar": "0.00",
"vitamin_a": "0",
"vitamin_c": "1.1",
"calcium": "7",
"iron": "0.29"
},
{
"serving_id": "43104",
"serving_description": "1 oz",
"serving_url": "https://www.fatsecret.com/calories-nutrition/usda/sliced-ham--(regular-approx-11%25-fat)?portionid=43104&portionamount=1.000",
"metric_serving_amount": "28.350",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "oz",
"calories": "46",
"carbohydrate": "1.09",
"protein": "4.71",
"fat": "2.44",
"saturated_fat": "0.832",
"polyunsaturated_fat": "0.224",
"monounsaturated_fat": "1.234",
"cholesterol": "16",
"sodium": "370",
"potassium": "81",
"fiber": "0.4",
"sugar": "0.00",
"vitamin_a": "0",
"vitamin_c": "1.1",
"calcium": "7",
"iron": "0.29"
}
]
}
}
},
{
"food_id": 7350,
"food_entry_name": "Cappuccino",
"eaten": {
"singular_description": "",
"plural_description": "",
"units": 1.0,
"total_metric_amount": 240,
"per_unit_metric_amount": 240,
"total_nutritional_content": {
"calories": "74",
"carbohydrate": "5.81",
"protein": "4.08",
"fat": "3.98",
"saturated_fat": "2.273",
"polyunsaturated_fat": "0.241",
"monounsaturated_fat": "1.007",
"cholesterol": "12",
"sodium": "50",
"potassium": "233",
"fiber": "0.2",
"sugar": "6.41",
"vitamin_a": "34",
"vitamin_c": "0.0",
"calcium": "144",
"iron": "0.19"
}
},
"suggested_serving": {
"serving_id": 28300,
"serving_description": "1 mug (8 fl oz)",
"metric_measure_amount": 240.000,
"number_of_units": "1"
},
"food": {
"food_id": "7350",
"food_name": "Cappuccino",
"food_type": "Generic",
"food_url": "https://www.fatsecret.com/calories-nutrition/generic/cappuccino",
"servings": {
"serving": [
{
"serving_id": "28300",
"serving_description": "1 mug (8 fl oz)",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cappuccino?portionid=28300&portionamount=1.000",
"metric_serving_amount": "240.000",
"metric_serving_unit": "g",
"is_default": true,
"number_of_units": "1.000",
"measurement_description": "mug (8 fl oz)",
"calories": "74",
"carbohydrate": "5.81",
"protein": "4.08",
"fat": "3.98",
"saturated_fat": "2.273",
"polyunsaturated_fat": "0.241",
"monounsaturated_fat": "1.007",
"cholesterol": "12",
"sodium": "50",
"potassium": "233",
"fiber": "0.2",
"sugar": "6.41",
"vitamin_a": "34",
"vitamin_c": "0",
"calcium": "144",
"iron": "0.19"
},
{
"serving_id": "1136795",
"serving_description": "100 ml",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cappuccino?portionid=1136795&portionamount=100.000",
"metric_serving_amount": "101.442",
"metric_serving_unit": "g",
"number_of_units": "100.000",
"measurement_description": "ml",
"calories": "31",
"carbohydrate": "2.45",
"protein": "1.72",
"fat": "1.68",
"saturated_fat": "0.961",
"polyunsaturated_fat": "0.102",
"monounsaturated_fat": "0.426",
"cholesterol": "5",
"sodium": "21",
"potassium": "98",
"fiber": "0.1",
"sugar": "2.71",
"vitamin_a": "14",
"vitamin_c": "0",
"calcium": "61",
"iron": "0.08"
},
{
"serving_id": "27229",
"serving_description": "1 coffee cup (6 fl oz)",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cappuccino?portionid=27229&portionamount=1.000",
"metric_serving_amount": "180.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "coffee cup (6 fl oz)",
"calories": "56",
"carbohydrate": "4.36",
"protein": "3.06",
"fat": "2.99",
"saturated_fat": "1.704",
"polyunsaturated_fat": "0.180",
"monounsaturated_fat": "0.756",
"cholesterol": "9",
"sodium": "38",
"potassium": "175",
"fiber": "0.2",
"sugar": "4.81",
"vitamin_a": "25",
"vitamin_c": "0",
"calcium": "108",
"iron": "0.14"
},
{
"serving_id": "56030",
"serving_description": "100 g",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cappuccino?portionid=56030&portionamount=100.000",
"metric_serving_amount": "100.000",
"metric_serving_unit": "g",
"number_of_units": "100.000",
"measurement_description": "g",
"calories": "31",
"carbohydrate": "2.42",
"protein": "1.70",
"fat": "1.66",
"saturated_fat": "0.947",
"polyunsaturated_fat": "0.100",
"monounsaturated_fat": "0.420",
"cholesterol": "5",
"sodium": "21",
"potassium": "97",
"fiber": "0.1",
"sugar": "2.67",
"vitamin_a": "14",
"vitamin_c": "0",
"calcium": "60",
"iron": "0.08"
},
{
"serving_id": "27060",
"serving_description": "1 medium",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cappuccino?portionid=27060&portionamount=1.000",
"metric_serving_amount": "486.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "medium",
"calories": "151",
"carbohydrate": "11.76",
"protein": "8.26",
"fat": "8.07",
"saturated_fat": "4.602",
"polyunsaturated_fat": "0.487",
"monounsaturated_fat": "2.040",
"cholesterol": "24",
"sodium": "102",
"potassium": "471",
"fiber": "0.5",
"sugar": "12.98",
"vitamin_a": "68",
"vitamin_c": "0",
"calcium": "292",
"iron": "0.39"
},
{
"serving_id": "27157",
"serving_description": "1 large",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cappuccino?portionid=27157&portionamount=1.000",
"metric_serving_amount": "578.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "large",
"calories": "179",
"carbohydrate": "13.99",
"protein": "9.83",
"fat": "9.60",
"saturated_fat": "5.473",
"polyunsaturated_fat": "0.579",
"monounsaturated_fat": "2.426",
"cholesterol": "29",
"sodium": "121",
"potassium": "561",
"fiber": "0.6",
"sugar": "15.43",
"vitamin_a": "81",
"vitamin_c": "0",
"calcium": "347",
"iron": "0.46"
},
{
"serving_id": "26732",
"serving_description": "1 serving (486 g)",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cappuccino?portionid=26732&portionamount=1.000",
"metric_serving_amount": "486.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "serving (486g)",
"calories": "151",
"carbohydrate": "11.76",
"protein": "8.26",
"fat": "8.07",
"saturated_fat": "4.602",
"polyunsaturated_fat": "0.487",
"monounsaturated_fat": "2.040",
"cholesterol": "24",
"sodium": "102",
"potassium": "471",
"fiber": "0.5",
"sugar": "12.98",
"vitamin_a": "68",
"vitamin_c": "0",
"calcium": "292",
"iron": "0.39"
},
{
"serving_id": "28637",
"serving_description": "1 cup (8 fl oz)",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cappuccino?portionid=28637&portionamount=1.000",
"metric_serving_amount": "240.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "cup (8 fl oz)",
"calories": "74",
"carbohydrate": "5.81",
"protein": "4.08",
"fat": "3.98",
"saturated_fat": "2.273",
"polyunsaturated_fat": "0.241",
"monounsaturated_fat": "1.007",
"cholesterol": "12",
"sodium": "50",
"potassium": "233",
"fiber": "0.2",
"sugar": "6.41",
"vitamin_a": "34",
"vitamin_c": "0",
"calcium": "144",
"iron": "0.19"
},
{
"serving_id": "26809",
"serving_description": "1 small",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cappuccino?portionid=26809&portionamount=1.000",
"metric_serving_amount": "365.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "small",
"calories": "113",
"carbohydrate": "8.83",
"protein": "6.21",
"fat": "6.06",
"saturated_fat": "3.456",
"polyunsaturated_fat": "0.366",
"monounsaturated_fat": "1.532",
"cholesterol": "18",
"sodium": "77",
"potassium": "354",
"fiber": "0.4",
"sugar": "9.75",
"vitamin_a": "51",
"vitamin_c": "0",
"calcium": "219",
"iron": "0.29"
},
{
"serving_id": "27228",
"serving_description": "1 fl oz",
"serving_url": "https://www.fatsecret.com/calories-nutrition/generic/cappuccino?portionid=27228&portionamount=1.000",
"metric_serving_amount": "30.000",
"metric_serving_unit": "g",
"number_of_units": "1.000",
"measurement_description": "fl oz",
"calories": "9",
"carbohydrate": "0.73",
"protein": "0.51",
"fat": "0.50",
"saturated_fat": "0.284",
"polyunsaturated_fat": "0.030",
"monounsaturated_fat": "0.126",
"cholesterol": "1",
"sodium": "6",
"potassium": "29",
"fiber": "0",
"sugar": "0.80",
"vitamin_a": "4",
"vitamin_c": "0",
"calcium": "18",
"iron": "0.02"
}
]
}
}
}
]
}Error Codes
| CODE | TYPE | DESCRIPTION |
|---|---|---|
| 2 | OAuth 1.0 | Missing required oauth parameter: '<details>' |
| 3 | OAuth 1.0 | Unsupported oauth parameter: '<details>' |
| 4 | OAuth 1.0 | Invalid signature method: '<details>' |
| 5 | OAuth 1.0 | Invalid consumer key: '<details>' |
| 6 | OAuth 1.0 | Invalid/expired timestamp: '<details>' |
| 7 | OAuth 1.0 | Invalid/used nonce: '<details>' |
| 8 | OAuth 1.0 | Invalid signature: '<details>' |
| 9 | OAuth 1.0 | Invalid access token: '<details>' |
| 12 | General | User is performing too many actions: '<details>' |
| 13 | OAuth 2.0 | Invalid token: '<details>' |
| 14 | OAuth 2.0 | Missing scope: '<details>' |
| 23 | General | Api not found |
| 24 | General | A timeout has occurred |
| 101 | Parameter | Missing required parameter: '<details>' |
| 107 | Parameter | Value out of range: '<details>' |
| 109 | Parameter | Character limit exceeded: '<details>' |