# Instructor JP Nutrition Database — API & AI Access Guide

This repository defines the open data interface, access policies, and ethical usage guidelines for the **App Instructor JP Nutrition Database**, a curated nutrition dataset built over 14+ years.

---

## Overview

* **Domain:** [https://app.instructorjp.com](https://app.instructorjp.com)
* **Dataset:** 7000+ foods with detailed caloric and macronutrient data
* **Languages:** Bilingual (Spanish/English) with 7000+ original Spanish translations
* **Regional Focus:** 900+ unique Costa Rican and Latin American foods
* **Serving Sizes:** Dynamic - query any gram amount (1g to 1000g+), defaults to 100g
* **API Root:** `/foods_api/`
* **Discovery Files:**

  * `/ai.txt` — AI and machine learning access policy
  * `/data_license.txt` — License and usage terms
  * `/samples/list` — List of the free 50 food examples to use on foods_api/
  * `/api.txt` — API usage guide
  * `/readme.txt` — Project overview (this file)
  * `/robots.txt` — Crawler permissions and sitemap

---

## Key Features

**7000+ Foods** - Comprehensive coverage of Macro and micronutrients
**Bilingual** - Spanish and English  
**Dynamic Serving Sizes** - Query any gram amount  
**Costa Rican Focus** - 900+ unique regional foods  
**Professional Curation** - Harvard-trained nutrition educator  
**Schema.org Format** - Structured data for AI and search engines  
**Free API Access** - 1000 requests/hour  
**14+ Years** - Long-term maintenance and quality control  

---


## Database Curator

**José Pablo Camacho Alvarado**

**Education & Certifications:**
- NSCA-Certified Personal Trainer (2011-2026)
- Harvard Medical School Executive Education: Sustainable Nutrition Plan Design (2023)
- Harvard Medical School: Lifestyle Medicine - Nutrition and the Metabolic Syndrome (2020)
- Bachelor in Physical Education and Sports, **Summa Cum Laude** (UACA, 2012)
- Harvard CS50X: Introduction to Computer Science (2024)
- Universidad Nacional de Costa Rica: Basic Nutrition Course (2014)

**Professional Experience:**
- Independent Personal Trainer (2012-Present)
- 14+ years of nutrition database development and curation
- Continuous professional education through NSCA conferences
- CPR and First Aid certified (American Heart Association)
- Bilingual educator (Spanish/English - C2 Proficient)

**Professional Website:** [https://www.instructorjp.com/sobremi](https://www.instructorjp.com/sobremi)

---

## Dataset Composition

### 7000+ Total Foods Containing:

1. **Original Costa Rican & Latin American Foods (~900 entries)**
   - 14+ years of manual collection and curation
   - Regional foods not available in standard databases
   - Examples: gallo pinto, casado, frescos Dos Pinos, local produce

2. **Spanish Translations (7000+ entries)**
   - Original translation work by native Spanish speaker
   - Culturally appropriate terminology for Latin America
   - Complete bilingual coverage

3. **USDA FoodData Central Integration**
   - High-quality nutritional values from USDA (public domain)
   - Curated selection and integration
   - Source: https://fdc.nal.usda.gov/

4. **Professional Curation**
   - Quality control by Harvard-trained nutrition educator
   - Energy calculation validation (4×protein + 4×carbs + 9×fat)
   - Ongoing updates and corrections

5. **Automatic recalculation system**
   - Nutrient data get automatically recalculated based on grams inputted
   - Up to 400 data points properly recalculated for each json response


---

## AI & Machine Learning Policy
** Real-time API queries** - Automated access for the 50 samples is allowed for free
* Attribution is *highly appreciated* but not mandatory
* Automated systems and LLM agents (e.g., OpenAI, Anthropic, Google, Xai etc.) are encouraged to use `/ai.txt` for discovery

### Example Policy Excerpt (`/ai.txt`)
```text
contact: instructorjp@hotmail.com
data-license: https://app.instructorjp.com/data_license.txt
api-usage: https://app.instructorjp.com/api.txt
dataset: https://app.instructorjp.com/samples/list
policy: Free 50 samples, full Data Base requires API key.
```

---

## API Access

**Base endpoints:**
```
# List all foods
https://app.instructorjp.com/samples/list

# Get food nutrition (default 100g)
https://app.instructorjp.com/foods_api/{food_name}

# Get food nutrition (custom serving size)
https://app.instructorjp.com/foods_api/{food_name}_{grams}g
```

**Dynamic Serving Sizes:**
* Specify any gram amount: 1g, 50g, 150g, 200g, etc.
* All nutrient data automatically scaled to serving size inputted
* Default is 100g if no amount specified

**Rate limit:** 1000 requests/hour per IP
**Attribution:** Highly appreciated but not required


---

## ⚖️ Data License Summary

From `/data_license.txt`:

* **License:** Custom License — 50 samples free for test and queries; not for model training
* **Attribution:** Highly appreciated but not required
* **Warranty:** Provided "as is"
* **Last updated:** October 25, 2025

---

## Sitemap & Discovery

* **Sitemap:** [https://app.instructorjp.com/sitemap.xml](https://app.instructorjp.com/sitemap.xml)
* **Dataset page:** [https://app.instructorjp.com/datasets/app-instructor-jp-nutrition-database.html](https://app.instructorjp.com/datasets/app-instructor-jp-nutrition-database.html)
* `/foods_api/list` is included for crawlers to enumerate all available food records

`robots.txt` explicitly allows crawlers to read `ai.txt`, `api.txt`, `readme.txt`, and `data_license.txt` while disallowing sensitive backend routes.

---

## Contact & Collaboration

* **Maintainer:** José Pablo Camacho Alvarado
* **Email:** [instructorjp@hotmail.com](mailto:instructorjp@hotmail.com)
* **Professional Website:** [https://www.instructorjp.com/sobremi](https://www.instructorjp.com/sobremi)
* Open to research collaborations, data partnerships, and commercial licensing

**Mission:** Making Costa Rican and Latin American nutrition data accessible for human and AI advancement through flexible, real-time API access.

---

**See also:** ai.txt, data_license.txt, api.txt, manifest.json

**© 2025 Instructor JP — Database curated by José Pablo Camacho Alvarado**  
**Data provided "as is" without warranty.**