Nutrition

Search the food database

get/foods

Request

  • Base URL: https://exercise-api.ymove.app/api/v2
  • URL: https://exercise-api.ymove.app/api/v2/foods
  • Auth: one of:
    • API key in header X-API-Key
    • API key in query parameter api_key

Query parameters

querystring required

Search term (e.g. "chicken breast")

source'usda' | 'openfoodfacts'

Filter results to a single data source.

usdaOnlyboolean

Convenience alias for source=usda. Returns only USDA FoodData Central entries - ideal when you want clean generic foods without branded packaged-product clutter.

countrystring

ISO 3166-1 alpha-2 country code (e.g. "FR", "US", "NL"). Soft-boosts results tagged with this country in the ranking, so Open Food Facts products local to your users surface first. Does not hard-filter - generic USDA and world results still appear. Also accepted as cc.

per'100g' | '100ml'

Normalize nutrition values to a per-100g or per-100ml basis instead of the native serving size.

pageinteger

Page number

pageSizeinteger

Results per page

Response

Paginated list of foods with nutrition data

Example response

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "fdcId": 171077,
      "name": "Chicken, broilers or fryers, breast, skinless, boneless, meat only, cooked, grilled",
      "shortName": "Chicken Breast",
      "displayName": "Chicken Breast (grilled, lean)",
      "brand": null,
      "category": "Poultry Products",
      "servingSize": 100,
      "servingDescription": "100g",
      "calories": 165,
      "protein": 31,
      "fat": 3.6,
      "carbs": 0,
      "fiber": 0,
      "sugar": 0,
      "sodium": 74,
      "cholesterol": 85,
      "saturatedFat": 1,
      "barcode": null,
      "source": "usda"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.