Fatsecret Nutrition #

Developed by F3 Software 🚀

A Dart package for interacting with the FatSecret Nutrition API by F3 Software

Installation 📦 #

dependencies:
  dotenv: ^4.2.0
  fatsecret_nutrition: ^0.1.0

Usage 📚 #

Obtain Client ID and Client Secret #

1. Go to the FatSecret Platform Website
2. Sign up or log in
3. Create a new application
4. Copy the Client ID and Client Secret
5. Copy the .env.example file to .env in the project root.
6. Add the Client ID and Client Secret to the .env file.

CLIENT_ID=your_client_id
CLIENT_SECRET=your_client_secret

Set Up Environment Variables #

export CLIENT_ID=your_client_id
export CLIENT_SECRET=your_client_secret
export TOKEN_URL=https://oauth.fatsecret.com/connect/token
export API_URL=https://platform.fatsecret.com/rest/server.api

Initialize The Client #

final fatSecret = FatSecretNutrition(
    clientId: env['CLIENT_ID']!,
    clientSecret: env['CLIENT_SECRET']!,
    tokenUrl: env['TOKEN_URL']!,
    apiUrl: env['API_URL']!,
);

Search for Foods #

final foods = await fatSecret.search(
  FoodSearchV3Props(
    searchExpression: 'apple',
    maxResults: 10,
    pageNumber: 0,
  ),
);

Auto-complete Food Search #

final suggestions = await fatSecret.autoComplete(
  const FoodAutoCompleteV2Props(
    expression: 'apple',
  ),
);

Find Food by Barcode #

final food = await fatSecret.foodFindIdForBarcode(
  const FoodForBarcodeProps(
    barcode: '9300675079655',
  ),
);

Search for Brands #

final brands = await fatSecret.searchBrands(
  const FoodBrandsGetAllV2Props(
    startsWith: 'k',
    brandType: 'restaurant',
    language: 'en',
    region: 'US',
  ),
);

if (brands != null) {
  for (final brand in brands.foodBrands.foodBrand) {
    print('Brand: $brand');
  }
}

Get Food Categories #

final categories = await fatSecret.getFoodCategories(
  props: const FoodCategoriesProps(
    region: 'US',
    language: 'en',
  ),
);

if (categories != null) {
  for (final category in categories.foodCategories.foodCategory) {
    print('Category: ${category.foodCategoryName}');
    print('ID: ${category.foodCategoryId}');
    print('Description: ${category.foodCategoryDescription}');
  }
}

Get Food Sub-Categories #

final subCategories = await fatSecret.getFoodSubCategories(
  props: const FoodSubCategoriesProps(
    foodCategoryId: 3, // Breads & Cereals
    region: 'US',
    language: 'en',
  ),
);

if (subCategories != null) {
  for (final subCategory in subCategories.foodSubCategories.foodSubCategory) {
    print('Sub-category: $subCategory');
  }
}

Features #

License 📝 #

This project is licensed under the MIT License.