--- title: "Search foods by text. Return maximum of 20 items" method: GET path: "/foods/search/v2/interactive" tags: ["food"] --- # Search foods by text. Return maximum of 20 items `GET /foods/search/v2/interactive` ## Query parameters - `q` string, required - `context_lang` string - `context_user_id` number - `context_meal_name` string - `context_food_names` string - `context_addon_of` string - `context_index` string - `context_semantic` boolean - `context_match_strategy` 'standard' | 'semantic' | 'hybrid' - `context_preferred_nutrition_source` string ## Response `200` successful operation - FoodSearchV2Response - `count` integer, required - `debug_telemetry` object, nullable - `matches` FoodSearchV2MatchResponse[], required - `custom_addons` MealItemCustomAddonResponse[], required - `calculated_servings` number, nullable - `carbohydrate_g` number - `cc_columns` CcColumnsRequest - `cc_added_sugars` boolean, nullable - `cc_additives` boolean, nullable - `cc_beverage` boolean, nullable - `cc_calcium` boolean, nullable - `cc_complexcarbs` boolean, nullable - `cc_composite_dish` boolean, nullable - `cc_cooked` boolean, nullable - `cc_fish` boolean, nullable - `cc_fried` boolean, nullable - `cc_fruit` boolean, nullable - `cc_gluten_free` boolean, nullable - `cc_grains` boolean, nullable - `cc_healthy_fat` boolean, nullable - `cc_high_fiber` boolean, nullable - `cc_legume` boolean, nullable - `cc_meat` boolean, nullable - `cc_non_meat_animal_protein` boolean, nullable - `cc_nuts_seeds` boolean, nullable - `cc_omega_three` boolean, nullable - `cc_plant_based` boolean, nullable - `cc_plant_based_whole` boolean, nullable - `cc_plant_protein` boolean, nullable - `cc_pork` boolean, nullable - `cc_poultry` boolean, nullable - `cc_processed` boolean, nullable - `cc_protein` boolean, nullable - `cc_raw` boolean, nullable - `cc_redmeat` boolean, nullable - `cc_shellfish` boolean, nullable - `cc_simplecarbs` boolean, nullable - `cc_standalone_food` boolean, nullable - `cc_sugar_free` boolean, nullable - `cc_sugary_beverage` boolean, nullable - `cc_supplement` boolean, nullable - `cc_ultraprocessed` boolean, nullable - `cc_unhealthy_fat` boolean, nullable - `cc_vegetable` boolean, nullable - `cc_whole` boolean, nullable - `cc_whole_foods` boolean, nullable - `cc_servings` CcServingsResponse, nullable — Servings-weighted CC values. Keys match `CcColumnsRequest` fields. Values are derived from calculated servings (clamped to 0-5, rounded to 0.1) and the corresponding boolean CC flag, matching the `health_data_table` nutrients aggregation semantics for `cc_*` fields. - `custom_item` boolean, nullable - `energy_kcal` number - `fat_g` number - `fiber_g` number - `food_image_url` string, nullable, required - `food_name` string, required - `food_name_translations` object, nullable, required - `id` integer - `is_foundational_item` boolean — Derived from the resolved food ontology; true for structural container items that do not contribute numeric CC servings. - `netcarb_g` number - `nutrient_overrides` NutrientOverrideCollection - `aa_patient` NutrientOverridesResponse - `cc_columns` CcColumnsRequest - `cc_added_sugars` boolean, nullable - `cc_additives` boolean, nullable - `cc_beverage` boolean, nullable - `cc_calcium` boolean, nullable - `cc_complexcarbs` boolean, nullable - `cc_composite_dish` boolean, nullable - `cc_cooked` boolean, nullable - `cc_fish` boolean, nullable - `cc_fried` boolean, nullable - `cc_fruit` boolean, nullable - `cc_gluten_free` boolean, nullable - `cc_grains` boolean, nullable - `cc_healthy_fat` boolean, nullable - `cc_high_fiber` boolean, nullable - `cc_legume` boolean, nullable - `cc_meat` boolean, nullable - `cc_non_meat_animal_protein` boolean, nullable - `cc_nuts_seeds` boolean, nullable - `cc_omega_three` boolean, nullable - `cc_plant_based` boolean, nullable - `cc_plant_based_whole` boolean, nullable - `cc_plant_protein` boolean, nullable - `cc_pork` boolean, nullable - `cc_poultry` boolean, nullable - `cc_processed` boolean, nullable - `cc_protein` boolean, nullable - `cc_raw` boolean, nullable - `cc_redmeat` boolean, nullable - `cc_shellfish` boolean, nullable - `cc_simplecarbs` boolean, nullable - `cc_standalone_food` boolean, nullable - `cc_sugar_free` boolean, nullable - `cc_sugary_beverage` boolean, nullable - `cc_supplement` boolean, nullable - `cc_ultraprocessed` boolean, nullable - `cc_unhealthy_fat` boolean, nullable - `cc_vegetable` boolean, nullable - `cc_whole` boolean, nullable - `cc_whole_foods` boolean, nullable - `created_time` string, date-time, required - `metadata` object, nullable - `nutrients` NutrientEstimatesRequest - `added_sugars_g` number, nullable - `alcohol_g` number, nullable - `caffeine_mg` number, nullable - `calcium_mg` number, nullable - `carbohydrate_g` number, nullable - `cholesterol_mg` number, nullable - `choline_mg` number, nullable - `energy_kcal` number, nullable - `fat_g` number, nullable - `fattyacids_totalmonounsaturated_g` number, nullable - `fattyacids_totalpolyunsaturated_g` number, nullable - `fattyacids_totalsaturated_g` number, nullable - `fattyacids_totaltrans_g` number, nullable - `fiber_g` number, nullable - `folate_dfe_ug` number, nullable - `grams_per_cubic_inch` number, nullable - `insoluble_dietary_fiber_g` number, nullable - `iron_mg` number, nullable - `magnesium_mg` number, nullable - `netcarb_g` number, nullable - `niacin_mg` number, nullable - `omega_three_fatty_acids_g` number, nullable - `pantothenic_acid_mg` number, nullable - `phosphorus_mg` number, nullable - `polyols_g` number, nullable - `potassium_mg` number, nullable - `protein_g` number, nullable - `riboflavin_mg` number, nullable - `selenium_mcg` number, nullable - `sodium_mg` number, nullable - `soluble_dietary_fiber_g` number, nullable - `sugars_g` number, nullable - `thiamin_mg` number, nullable - `vitamin_a_iu` number, nullable - `vitamin_a_rae_ug` number, nullable - `vitamin_b12_ug` number, nullable - `vitamin_b6_mg` number, nullable - `vitamin_c_mg` number, nullable - `vitamin_d2d3_ug` number, nullable - `vitamin_d_iu` number, nullable - `vitamin_e_mg` number, nullable - `vitamin_k_ug` number, nullable - `water_g` number, nullable - `zinc_mg` number, nullable - `ontology` FoodOntologyVTO - `adult_serving_size_g` number, nullable - `ghg_equivalent_kg` number, nullable - `id` integer, nullable - `levels` string[], required - `source_id` string, required - `source_name` 'patient' | 'reviewer' | 'external' | 'estimate' | 'validation', required - `updated_time` string, date-time, required - `bb_reviewer` NutrientOverridesResponse - `cc_columns` CcColumnsRequest - `cc_added_sugars` boolean, nullable - `cc_additives` boolean, nullable - `cc_beverage` boolean, nullable - `cc_calcium` boolean, nullable - `cc_complexcarbs` boolean, nullable - `cc_composite_dish` boolean, nullable - `cc_cooked` boolean, nullable - `cc_fish` boolean, nullable - `cc_fried` boolean, nullable - `cc_fruit` boolean, nullable - `cc_gluten_free` boolean, nullable - `cc_grains` boolean, nullable - `cc_healthy_fat` boolean, nullable - `cc_high_fiber` boolean, nullable - `cc_legume` boolean, nullable - `cc_meat` boolean, nullable - `cc_non_meat_animal_protein` boolean, nullable - `cc_nuts_seeds` boolean, nullable - `cc_omega_three` boolean, nullable - `cc_plant_based` boolean, nullable - `cc_plant_based_whole` boolean, nullable - `cc_plant_protein` boolean, nullable - `cc_pork` boolean, nullable - `cc_poultry` boolean, nullable - `cc_processed` boolean, nullable - `cc_protein` boolean, nullable - `cc_raw` boolean, nullable - `cc_redmeat` boolean, nullable - `cc_shellfish` boolean, nullable - `cc_simplecarbs` boolean, nullable - `cc_standalone_food` boolean, nullable - `cc_sugar_free` boolean, nullable - `cc_sugary_beverage` boolean, nullable - `cc_supplement` boolean, nullable - `cc_ultraprocessed` boolean, nullable - `cc_unhealthy_fat` boolean, nullable - `cc_vegetable` boolean, nullable - `cc_whole` boolean, nullable - `cc_whole_foods` boolean, nullable - `created_time` string, date-time, required - `metadata` object, nullable - `nutrients` NutrientEstimatesRequest - `added_sugars_g` number, nullable - `alcohol_g` number, nullable - `caffeine_mg` number, nullable - `calcium_mg` number, nullable - `carbohydrate_g` number, nullable - `cholesterol_mg` number, nullable - `choline_mg` number, nullable - `energy_kcal` number, nullable - `fat_g` number, nullable - `fattyacids_totalmonounsaturated_g` number, nullable - `fattyacids_totalpolyunsaturated_g` number, nullable - `fattyacids_totalsaturated_g` number, nullable - `fattyacids_totaltrans_g` number, nullable - `fiber_g` number, nullable - `folate_dfe_ug` number, nullable - `grams_per_cubic_inch` number, nullable - `insoluble_dietary_fiber_g` number, nullable - `iron_mg` number, nullable - `magnesium_mg` number, nullable - `netcarb_g` number, nullable - `niacin_mg` number, nullable - `omega_three_fatty_acids_g` number, nullable - `pantothenic_acid_mg` number, nullable - `phosphorus_mg` number, nullable - `polyols_g` number, nullable - `potassium_mg` number, nullable - `protein_g` number, nullable - `riboflavin_mg` number, nullable - `selenium_mcg` number, nullable - `sodium_mg` number, nullable - `soluble_dietary_fiber_g` number, nullable - `sugars_g` number, nullable - `thiamin_mg` number, nullable - `vitamin_a_iu` number, nullable - `vitamin_a_rae_ug` number, nullable - `vitamin_b12_ug` number, nullable - `vitamin_b6_mg` number, nullable - `vitamin_c_mg` number, nullable - `vitamin_d2d3_ug` number, nullable - `vitamin_d_iu` number, nullable - `vitamin_e_mg` number, nullable - `vitamin_k_ug` number, nullable - `water_g` number, nullable - `zinc_mg` number, nullable - `ontology` FoodOntologyVTO - `adult_serving_size_g` number, nullable - `ghg_equivalent_kg` number, nullable - `id` integer, nullable - `levels` string[], required - `source_id` string, required - `source_name` 'patient' | 'reviewer' | 'external' | 'estimate' | 'validation', required - `updated_time` string, date-time, required - `cc_external` NutrientOverridesResponse - `cc_columns` CcColumnsRequest - `cc_added_sugars` boolean, nullable - `cc_additives` boolean, nullable - `cc_beverage` boolean, nullable - `cc_calcium` boolean, nullable - `cc_complexcarbs` boolean, nullable - `cc_composite_dish` boolean, nullable - `cc_cooked` boolean, nullable - `cc_fish` boolean, nullable - `cc_fried` boolean, nullable - `cc_fruit` boolean, nullable - `cc_gluten_free` boolean, nullable - `cc_grains` boolean, nullable - `cc_healthy_fat` boolean, nullable - `cc_high_fiber` boolean, nullable - `cc_legume` boolean, nullable - `cc_meat` boolean, nullable - `cc_non_meat_animal_protein` boolean, nullable - `cc_nuts_seeds` boolean, nullable - `cc_omega_three` boolean, nullable - `cc_plant_based` boolean, nullable - `cc_plant_based_whole` boolean, nullable - `cc_plant_protein` boolean, nullable - `cc_pork` boolean, nullable - `cc_poultry` boolean, nullable - `cc_processed` boolean, nullable - `cc_protein` boolean, nullable - `cc_raw` boolean, nullable - `cc_redmeat` boolean, nullable - `cc_shellfish` boolean, nullable - `cc_simplecarbs` boolean, nullable - `cc_standalone_food` boolean, nullable - `cc_sugar_free` boolean, nullable - `cc_sugary_beverage` boolean, nullable - `cc_supplement` boolean, nullable - `cc_ultraprocessed` boolean, nullable - `cc_unhealthy_fat` boolean, nullable - `cc_vegetable` boolean, nullable - `cc_whole` boolean, nullable - `cc_whole_foods` boolean, nullable - `created_time` string, date-time, required - `metadata` object, nullable - `nutrients` NutrientEstimatesRequest - `added_sugars_g` number, nullable - `alcohol_g` number, nullable - `caffeine_mg` number, nullable - `calcium_mg` number, nullable - `carbohydrate_g` number, nullable - `cholesterol_mg` number, nullable - `choline_mg` number, nullable - `energy_kcal` number, nullable - `fat_g` number, nullable - `fattyacids_totalmonounsaturated_g` number, nullable - `fattyacids_totalpolyunsaturated_g` number, nullable - `fattyacids_totalsaturated_g` number, nullable - `fattyacids_totaltrans_g` number, nullable - `fiber_g` number, nullable - `folate_dfe_ug` number, nullable - `grams_per_cubic_inch` number, nullable - `insoluble_dietary_fiber_g` number, nullable - `iron_mg` number, nullable - `magnesium_mg` number, nullable - `netcarb_g` number, nullable - `niacin_mg` number, nullable - `omega_three_fatty_acids_g` number, nullable - `pantothenic_acid_mg` number, nullable - `phosphorus_mg` number, nullable - `polyols_g` number, nullable - `potassium_mg` number, nullable - `protein_g` number, nullable - `riboflavin_mg` number, nullable - `selenium_mcg` number, nullable - `sodium_mg` number, nullable - `soluble_dietary_fiber_g` number, nullable - `sugars_g` number, nullable - `thiamin_mg` number, nullable - `vitamin_a_iu` number, nullable - `vitamin_a_rae_ug` number, nullable - `vitamin_b12_ug` number, nullable - `vitamin_b6_mg` number, nullable - `vitamin_c_mg` number, nullable - `vitamin_d2d3_ug` number, nullable - `vitamin_d_iu` number, nullable - `vitamin_e_mg` number, nullable - `vitamin_k_ug` number, nullable - `water_g` number, nullable - `zinc_mg` number, nullable - `ontology` FoodOntologyVTO - `adult_serving_size_g` number, nullable - `ghg_equivalent_kg` number, nullable - `id` integer, nullable - `levels` string[], required - `source_id` string, required - `source_name` 'patient' | 'reviewer' | 'external' | 'estimate' | 'validation', required - `updated_time` string, date-time, required - `dd_estimate` NutrientOverridesResponse - `cc_columns` CcColumnsRequest - `cc_added_sugars` boolean, nullable - `cc_additives` boolean, nullable - `cc_beverage` boolean, nullable - `cc_calcium` boolean, nullable - `cc_complexcarbs` boolean, nullable - `cc_composite_dish` boolean, nullable - `cc_cooked` boolean, nullable - `cc_fish` boolean, nullable - `cc_fried` boolean, nullable - `cc_fruit` boolean, nullable - `cc_gluten_free` boolean, nullable - `cc_grains` boolean, nullable - `cc_healthy_fat` boolean, nullable - `cc_high_fiber` boolean, nullable - `cc_legume` boolean, nullable - `cc_meat` boolean, nullable - `cc_non_meat_animal_protein` boolean, nullable - `cc_nuts_seeds` boolean, nullable - `cc_omega_three` boolean, nullable - `cc_plant_based` boolean, nullable - `cc_plant_based_whole` boolean, nullable - `cc_plant_protein` boolean, nullable - `cc_pork` boolean, nullable - `cc_poultry` boolean, nullable - `cc_processed` boolean, nullable - `cc_protein` boolean, nullable - `cc_raw` boolean, nullable - `cc_redmeat` boolean, nullable - `cc_shellfish` boolean, nullable - `cc_simplecarbs` boolean, nullable - `cc_standalone_food` boolean, nullable - `cc_sugar_free` boolean, nullable - `cc_sugary_beverage` boolean, nullable - `cc_supplement` boolean, nullable - `cc_ultraprocessed` boolean, nullable - `cc_unhealthy_fat` boolean, nullable - `cc_vegetable` boolean, nullable - `cc_whole` boolean, nullable - `cc_whole_foods` boolean, nullable - `created_time` string, date-time, required - `metadata` object, nullable - `nutrients` NutrientEstimatesRequest - `added_sugars_g` number, nullable - `alcohol_g` number, nullable - `caffeine_mg` number, nullable - `calcium_mg` number, nullable - `carbohydrate_g` number, nullable - `cholesterol_mg` number, nullable - `choline_mg` number, nullable - `energy_kcal` number, nullable - `fat_g` number, nullable - `fattyacids_totalmonounsaturated_g` number, nullable - `fattyacids_totalpolyunsaturated_g` number, nullable - `fattyacids_totalsaturated_g` number, nullable - `fattyacids_totaltrans_g` number, nullable - `fiber_g` number, nullable - `folate_dfe_ug` number, nullable - `grams_per_cubic_inch` number, nullable - `insoluble_dietary_fiber_g` number, nullable - `iron_mg` number, nullable - `magnesium_mg` number, nullable - `netcarb_g` number, nullable - `niacin_mg` number, nullable - `omega_three_fatty_acids_g` number, nullable - `pantothenic_acid_mg` number, nullable - `phosphorus_mg` number, nullable - `polyols_g` number, nullable - `potassium_mg` number, nullable - `protein_g` number, nullable - `riboflavin_mg` number, nullable - `selenium_mcg` number, nullable - `sodium_mg` number, nullable - `soluble_dietary_fiber_g` number, nullable - `sugars_g` number, nullable - `thiamin_mg` number, nullable - `vitamin_a_iu` number, nullable - `vitamin_a_rae_ug` number, nullable - `vitamin_b12_ug` number, nullable - `vitamin_b6_mg` number, nullable - `vitamin_c_mg` number, nullable - `vitamin_d2d3_ug` number, nullable - `vitamin_d_iu` number, nullable - `vitamin_e_mg` number, nullable - `vitamin_k_ug` number, nullable - `water_g` number, nullable - `zinc_mg` number, nullable - `ontology` FoodOntologyVTO - `adult_serving_size_g` number, nullable - `ghg_equivalent_kg` number, nullable - `id` integer, nullable - `levels` string[], required - `source_id` string, required - `source_name` 'patient' | 'reviewer' | 'external' | 'estimate' | 'validation', required - `updated_time` string, date-time, required - `ee_validation` NutrientOverridesResponse - `cc_columns` CcColumnsRequest - `cc_added_sugars` boolean, nullable - `cc_additives` boolean, nullable - `cc_beverage` boolean, nullable - `cc_calcium` boolean, nullable - `cc_complexcarbs` boolean, nullable - `cc_composite_dish` boolean, nullable - `cc_cooked` boolean, nullable - `cc_fish` boolean, nullable - `cc_fried` boolean, nullable - `cc_fruit` boolean, nullable - `cc_gluten_free` boolean, nullable - `cc_grains` boolean, nullable - `cc_healthy_fat` boolean, nullable - `cc_high_fiber` boolean, nullable - `cc_legume` boolean, nullable - `cc_meat` boolean, nullable - `cc_non_meat_animal_protein` boolean, nullable - `cc_nuts_seeds` boolean, nullable - `cc_omega_three` boolean, nullable - `cc_plant_based` boolean, nullable - `cc_plant_based_whole` boolean, nullable - `cc_plant_protein` boolean, nullable - `cc_pork` boolean, nullable - `cc_poultry` boolean, nullable - `cc_processed` boolean, nullable - `cc_protein` boolean, nullable - `cc_raw` boolean, nullable - `cc_redmeat` boolean, nullable - `cc_shellfish` boolean, nullable - `cc_simplecarbs` boolean, nullable - `cc_standalone_food` boolean, nullable - `cc_sugar_free` boolean, nullable - `cc_sugary_beverage` boolean, nullable - `cc_supplement` boolean, nullable - `cc_ultraprocessed` boolean, nullable - `cc_unhealthy_fat` boolean, nullable - `cc_vegetable` boolean, nullable - `cc_whole` boolean, nullable - `cc_whole_foods` boolean, nullable - `created_time` string, date-time, required - `metadata` object, nullable - `nutrients` NutrientEstimatesRequest - `added_sugars_g` number, nullable - `alcohol_g` number, nullable - `caffeine_mg` number, nullable - `calcium_mg` number, nullable - `carbohydrate_g` number, nullable - `cholesterol_mg` number, nullable - `choline_mg` number, nullable - `energy_kcal` number, nullable - `fat_g` number, nullable - `fattyacids_totalmonounsaturated_g` number, nullable - `fattyacids_totalpolyunsaturated_g` number, nullable - `fattyacids_totalsaturated_g` number, nullable - `fattyacids_totaltrans_g` number, nullable - `fiber_g` number, nullable - `folate_dfe_ug` number, nullable - `grams_per_cubic_inch` number, nullable - `insoluble_dietary_fiber_g` number, nullable - `iron_mg` number, nullable - `magnesium_mg` number, nullable - `netcarb_g` number, nullable - `niacin_mg` number, nullable - `omega_three_fatty_acids_g` number, nullable - `pantothenic_acid_mg` number, nullable - `phosphorus_mg` number, nullable - `polyols_g` number, nullable - `potassium_mg` number, nullable - `protein_g` number, nullable - `riboflavin_mg` number, nullable - `selenium_mcg` number, nullable - `sodium_mg` number, nullable - `soluble_dietary_fiber_g` number, nullable - `sugars_g` number, nullable - `thiamin_mg` number, nullable - `vitamin_a_iu` number, nullable - `vitamin_a_rae_ug` number, nullable - `vitamin_b12_ug` number, nullable - `vitamin_b6_mg` number, nullable - `vitamin_c_mg` number, nullable - `vitamin_d2d3_ug` number, nullable - `vitamin_d_iu` number, nullable - `vitamin_e_mg` number, nullable - `vitamin_k_ug` number, nullable - `water_g` number, nullable - `zinc_mg` number, nullable - `ontology` FoodOntologyVTO - `adult_serving_size_g` number, nullable - `ghg_equivalent_kg` number, nullable - `id` integer, nullable - `levels` string[], required - `source_id` string, required - `source_name` 'patient' | 'reviewer' | 'external' | 'estimate' | 'validation', required - `updated_time` string, date-time, required - `preparation_method` '' | 'homemade' | 'restaurant' | 'cpg' | 'store_bought' | 'other' - `protein_g` number - `rxfood_id` string, nullable - `serving_unit_amount` number, required - `serving_unit_label` string, required - `serving_unit_label_translations` object, nullable, required - `servings` number, required - `source_meal_id` integer, nullable — meal id the row was copied from when logging from recent items - `source_meal_item_custom_addon_id` integer, nullable — custom addon id the row was copied from when logging from recent items - `source_meal_item_id` integer, nullable — meal item id the row was copied from when logging from recent items - `food_name` string, required - `food_name_alias` string, nullable, required - `food_name_alias_translations` object, nullable, required - `food_name_translations` object, nullable, required - `food_photo_url` string, nullable, required - `food_status` string, nullable, required - `id` string, required - `is_from_user_recents` boolean, required - `meta` object, nullable - `nutrition_source` string, nullable - `score` number, required - `serving_units` FoodServingUnit[], required - `addon` boolean - `amount` number, required - `default_label_qty` number, required - `food_sizing_options` string[] - `label` string, required - `label_translations` object, nullable, required - `ranking` integer - `root_label` string - `suggestions` FoodSearchV2SuggestionResponse[], required - `length` integer, required - `offset` integer, required - `options` FoodSearchV2SuggestionOption[], required - `score` number, required - `text` string, required - `text` string, required --- [API](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server.md) · [All operations](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server/llms.txt) · [OpenAPI document](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server/revisions/750cc0d96a93?raw)