# Instructor JP — Platform & API Access Guide

This document defines the platform overview, access policies, and API guidelines for **Instructor JP**, a professional fitness technology platform built over 20+ years of training experience.

---

## Platform Overview

* **Platform:** Instructor JP
* **Type:** Professional fitness technology platform
* **Domain:** [https://app.instructorjp.com](https://app.instructorjp.com)
* **Description:** Exercise databases, workout builders, nutrition tracking, and AI-powered fitness tools built by an NSCA-CPT certified trainer with Harvard education.
* **Area Served:** Worldwide
* **Languages:** Bilingual (English / Spanish)
* **Founded:** 2012

---

## Apps & Products

| Product | Platform | Status | Description |
|---------|----------|--------|-------------|
| **Instructor JP Full** | iOS & Android | Coming 2026 | Complete fitness platform — training + nutrition in one app. Live Polar HR, workout programs, meal tracking, progress analytics. |
| **Instructor JP** | iOS & Android | Coming 2026 | Professional training app with live Polar heart rate monitoring, 510+ exercises with video demos, NSCA-based workout programs. |
| **Instructor JP Diet** | iOS & Android | Coming 2026 | Precision nutrition tracking synced with training data. 7,100+ foods including 900+ Latin American entries. |
| **Instructor JP ChatGPT** | Web (ChatGPT) | In Review | AI-powered fitness tools via MCP integration — exercise search, workout builder, nutrition lookup inside ChatGPT. |
| **Nutrition API** | Web | Live | REST API providing nutrition data for 7,100+ foods with dynamic serving size calculations. |

---

## Exercise Database

* **Total Exercises:** 510+
* **Professional Videos:** 148 slow-motion, multi-angle demonstrations
* **Video Performer:** NSCA-CPT certified trainer (José Pablo Camacho Alvarado)
* **Data Included:** Biomechanical analysis, muscle activation, difficulty ratings, equipment requirements
* **Access Policy:** Private — authorized business partners only
* **License:** [/exercise_data_license.txt](https://app.instructorjp.com/exercise_data_license.txt)
* **AI Training:** Not permitted
* **Public API:** Not available

---

## Nutrition Database

* **Total Foods:** 7,100+ with detailed caloric and macronutrient data
* **Unique additions:** 900+ unique Costa Rican and Latin American foods
* **Languages:** Bilingual (Spanish/English) with 7,100+ original Spanish translations
* **Serving Sizes:** Dynamic — query any gram amount (1g to 1000g+), defaults to 100g
* **Data Points:** Up to 400+ nutrients per food (macros, vitamins, minerals, amino acids, fatty acids)
* **API Root:** `/foods_api/`
* **Access Policy:** 50 free samples, full database requires API key
* **License:** [/food_data_license.txt](https://app.instructorjp.com/food_data_license.txt)
* **AI Training:** Not permitted

---

## Discovery Files

| File | Purpose |
|------|---------|
| `/ai.txt` | AI and machine learning access policy |
| `/food_data_license.txt` | Nutrition database license and usage terms |
| `/exercise_data_license.txt` | Exercise database license and usage terms |
| `/samples/list` | List of free 50 food samples for API testing |
| `/api.txt` | API usage guide |
| `/readme.txt` | Project overview (this file) |
| `/robots.txt` | Crawler permissions and sitemap |
| `/manifest.json` | Dataset manifest |

---

## 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)
- 5,000+ clients trained from 15+ countries
- 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)

---

## Nutrition Dataset Composition

### 7,100+ 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 (7,100+ 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 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:** Highly appreciated but not mandatory
* **AI Training:** Not permitted for either database
* **Dataset Replication:** Not permitted
* **Discovery:** Automated systems and LLM agents (OpenAI, Anthropic, Google, xAI, etc.) are encouraged to use `/ai.txt` for discovery

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

---

## API Access

**Base endpoints:**
```
# List all sample 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

**Nutrition Database** (`/food_data_license.txt`):
* **License:** Custom License — 50 samples free for testing and queries; not for model training
* **Attribution:** Highly appreciated but not required
* **Warranty:** Provided "as is"

**Exercise Database** (`/exercise_data_license.txt`):
* **License:** Private — authorized business partners only
* **Public Access:** Not available
* **AI Training:** Not permitted

---

## 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)
* **Homepage:** [https://app.instructorjp.com](https://app.instructorjp.com)

`robots.txt` explicitly allows crawlers to read `ai.txt`, `api.txt`, `readme.txt`, `exercise_data_license.txt`, and `food_data_license.txt` while disallowing sensitive backend routes and model training bots.

---

## 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)
* **YouTube:** [https://www.youtube.com/@instructorjp](https://www.youtube.com/@instructorjp)

Open to research collaborations, data partnerships, and commercial licensing discussions.

**Mission:** Making professional fitness technology accessible worldwide — exercise science, nutrition data, and training tools built on 20+ years of real coaching experience.

---

**See also:** ai.txt, food_data_license.txt, exercise_data_license.txt, api.txt, manifest.json

**© 2026 Instructor JP — Platform built by José Pablo Camacho Alvarado**  
**Data provided "as is" without warranty.**