Thrive X DNA Fitness & Nutrition API Documentation

Complete documentation for the Thrive X DNA Fitness & Nutrition API, including all endpoints, request parameters, and response formats.

Introduction

The Thrive X DNA Fitness & Nutrition API is designed to empower developers, fitness enthusiasts, and health professionals with cutting-edge tools for personalized fitness and nutrition management. Powered by advanced AI through Anthropic and OpenAI integration, this API offers a suite of endpoints to generate tailored workout plans, detailed exercise information, comprehensive nutrition advice, custom meal plans, food plate analysis, food ingredient details, and natural remedies. Whether you're building a fitness app, optimizing your own training, or exploring dietary options, our API provides flexible, data-driven solutions. Key features include support for diverse fitness goals, dietary preferences (e.g., carnivore, vegan), real-time nutritional analysis, ingredient breakdowns, and natural health solutions, all accessible via a RESTful interface returning JSON data.

Authentication

To access the Thrive X DNA Fitness & Nutrition API, every request must include an API key in the header. This key is provided upon subscription and ensures secure access to our services. For certain administrative routes (e.g., `/admin` endpoints), additional authentication via Supabase tokens is required, which is handled server-side for authorized users only.

X-API-Key: your_api_key_here

To obtain an API key, subscribe to one of our plans (see Rate Limits below) or contact support@thrivexdna.com for assistance.

Rate Limits

The Thrive X DNA Fitness & Nutrition API enforces rate limits based on your subscription tier to ensure fair usage and optimal performance. Exceeding these limits results in a 429 Too Many Requests response. Below are the available subscription tiers with their monthly request quotas, additional per-request costs, and rate limits:

Tier Cost Requests/Month Additional Cost Rate Limit
Core $14.99/mo 500 $0.04/request 1 request/second
Elite $49.00/mo 15,000 $0.025/request 3 requests/second
Ultimate ⭐️ Recommended $129.00/mo 75,000 $0.015/request 20 requests/second

Notes: Higher tiers (Core, Elite, Ultimate) allow additional requests beyond the monthly quota at the specified rates. Rate limits are enforced per API key. For custom plans or Ultimate solutions, contact support@thrivexdna.com.

POST /api/fitness/workout

Create a personalized workout plan based on your goals, fitness level, and preferences. This endpoint uses Anthropic's AI models for generating workout plans.

Request Parameters

Parameter Type Required Description
goals string Yes Fitness goals (e.g., "endurance", "strength", "weight_loss")
fitnessLevel string Yes Fitness level (e.g., "beginner", "intermediate", "advanced")
preferences array No Exercise preferences (e.g., ["weight_training", "cardio", "yoga"])
bodyFocus string No Body focus area (e.g., "upper_body", "lower_body", "full_body")
muscleGroups array No Target muscle groups (e.g., ["chest", "legs"])
includeWarmupCooldown boolean No Include warmup and cooldown (default: false)
daysPerWeek integer Yes Days per week (1-7)
sessionDuration integer Yes Session duration in minutes (e.g., 90)
planDurationWeeks integer Yes Plan duration in weeks (e.g., 3)

Example Request

{ "goals": "endurance", "fitnessLevel": "intermediate", "preferences": ["weight_training", "cardio", "hiit", "bodyweight", "yoga"], "bodyFocus": "full_body", "muscleGroups": ["legs", "core"], "includeWarmupCooldown": true, "daysPerWeek": 5, "sessionDuration": 90, "planDurationWeeks": 3 }

Example Response

{ "success": true, "data": { "name": "Endurance Hybrid Plan", "goals": "endurance", "fitnessLevel": "intermediate", "daysPerWeek": 5, "planDurationWeeks": 3, "days": [ { "name": "Week 1 - Monday - Cardio & Weight Training", "sessionDuration": "90 minutes", "exercises": [ {"name": "Treadmill Running (Moderate Pace)", "sets": 1, "reps": "30 min", "restSeconds": 0, "muscleGroup": "legs"}, {"name": "Dumbbell Lunges", "sets": 3, "reps": 12, "restSeconds": 60, "muscleGroup": "legs"}, {"name": "Kettlebell Swings", "sets": 3, "reps": 15, "restSeconds": 60, "muscleGroup": "core"}, {"name": "Cool-Down Jog", "sets": 1, "reps": "15 min", "restSeconds": 0, "muscleGroup": "legs"} ] }, { "name": "Week 1 - Tuesday - HIIT & Bodyweight", "sessionDuration": "90 minutes", "exercises": [ {"name": "Sprint Intervals (30s sprint, 90s walk)", "sets": 10, "reps": "2 min cycle", "restSeconds": 0, "muscleGroup": "legs"}, {"name": "Burpees", "sets": 4, "reps": 15, "restSeconds": 45, "muscleGroup": "full_body"}, {"name": "Mountain Climbers", "sets": 4, "reps": "45s", "restSeconds": 45, "muscleGroup": "core"}, {"name": "Bodyweight Squats", "sets": 3, "reps": 20, "restSeconds": 60, "muscleGroup": "legs"} ] } ] } }
POST /api/fitness/exercise

Get detailed information about a specific exercise, including proper form and target muscles. This endpoint uses Anthropic's AI models for providing exercise details.

Request Parameters

Parameter Type Required Description
exerciseId string Yes Name of the exercise (e.g., "Squat")
includeVariations boolean No Include exercise variations (default: false)

Example Request

{ "exerciseId": "Squat", "includeVariations": true }

Example Response

{ "success": true, "data": { "name": "Squat", "muscleGroups": ["Quadriceps", "Glutes", "Hamstrings"], "equipment": "Barbell or Bodyweight", "instructions": "Stand with feet shoulder-width apart, lower your hips...", "difficulty": "Intermediate", "tips": ["Keep back straight", "Knees over toes", "Engage core"], "variations": ["Front Squat", "Goblet Squat"] } }
POST /api/fitness/meal-plan

Get personalized nutrition advice and a custom meal plan tailored to your goals, preferences, and needs. This endpoint uses Anthropic's AI models for generating nutrition and meal plans.

Request Parameters

Parameter Type Required Description
goals string Yes Nutrition goals (e.g., "muscle_gain", "weight_loss")
dietType string Yes Diet type (e.g., "vegetarian", "carnivore", "vegan")
gender string Yes Gender (e.g., "male", "female")
age integer Yes Age in years
weight number Yes Weight in kg
heightCm number Yes Height in cm
activityLevel string Yes Activity level (e.g., "sedentary", "lightly", "active")
allergies array No Allergies (e.g., ["peanuts", "gluten"])
religiousPreferences string No Religious dietary preferences (e.g., "halal", "kosher", "none")
calorieTarget integer Yes Daily calorie target (e.g., 3500)
mealsPerDay integer Yes Meals per day (e.g., 6)
numberOfDays integer Yes Number of days for the plan (e.g., 7)

Example Request

{ "goals": "muscle_gain", "dietType": "vegetarian", "gender": "male", "age": 32, "weight": 112.49, "heightCm": 193.04, "activityLevel": "lightly", "allergies": ["peanuts", "dairy", "gluten", "shellfish", "soy", "tree nuts"], "religiousPreferences": "halal", "calorieTarget": 3500, "mealsPerDay": 6, "numberOfDays": 7 }

Example Response

{ "success": true, "data": { "macros": {"protein": 245, "fat": 117, "carbs": 377, "totalCalories": 3500}, "recommendations": { "general": "To support muscle gain on a vegetarian, halal diet, focus on high-protein plant-based sources...", "keyPoints": [ "Prioritize halal-certified legumes, quinoa, and seeds for protein.", "Use gluten-free grains like rice and oats for carbs.", "Incorporate olive oil and avocado for allergen-free fats." ], "mealPlan": [ { "day": "Day 1", "meals": [ {"mealName": "Breakfast", "foods": [ {"name": "Oatmeal (Gluten-Free) with Chia Seeds", "calories": 600, "protein": 20, "fat": 20, "carbs": 90} ]}, {"mealName": "Dinner", "foods": [ {"name": "Lentil Curry with Brown Rice", "calories": 750, "protein": 30, "fat": 20, "carbs": 105} ]} ] } ] } } }
POST /api/fitness/analyzeFoodPlate

Upload an image of your food plate to analyze its nutritional content. This endpoint uses OpenAI's AI models for food image analysis.

Request Parameters (FormData)

Parameter Type Required Description
food_image file Yes Image file of the food plate
cooking_oil string No Optional cooking oil type (e.g., "olive_oil")

Example Request

Content-Type: multipart/form-data X-API-Key: your_api_key_here Body: - food_image: [file] - cooking_oil: "olive_oil"

Example Response

{ "success": true, "data": { "title": "Food Plate Analysis", "foods": [ {"name": "Grilled Chicken", "calories": 200, "protein": 30, "fat": 5, "carbs": 0}, {"name": "Steamed Broccoli", "calories": 50, "protein": 3, "fat": 0, "carbs": 10} ] } }
POST /api/fitness/food-ingredient

Explore detailed information about food ingredients, chemicals, and label items, including definitions, layman's terms, production methods, and usage examples. This endpoint uses Anthropic's AI models for generating food ingredient information.

Request Parameters

Parameter Type Required Description
ingredient string Yes Name of the ingredient to search (e.g., "Ascorbic Acid")

Example Request

{ "ingredient": "Ascorbic Acid" }

Example Response

{ "success": true, "data": { "name": "Ascorbic Acid", "category": "Vitamin", "origin": "Synthetic or natural (e.g., citrus fruits)", "safety_rating": "Generally Recognized as Safe (GRAS)", "definition": "A water-soluble vitamin (C6H8O6) essential for collagen synthesis and antioxidant activity.", "layman_term": "Vitamin C - keeps your skin healthy and fights off colds.", "production_process": "Synthesized from glucose via fermentation or chemical processes.", "example_use": "Added to orange juice to boost vitamin content." } }
POST /api/fitness/natural-remedies

Get natural remedy variations for a specific symptom, including efficacy ratings, ingredients, and preparation steps. This endpoint uses Anthropic's AI models for generating natural remedy information.

Important Medical Disclaimer: These remedies and approaches are provided for informational purposes only and are not intended to diagnose, treat, cure, or prevent any disease. They represent traditional or alternative perspectives that have not been evaluated by the FDA.

Always consult qualified healthcare professionals for medical conditions, especially for serious conditions like cancer, diabetes, heart disease, and other chronic or acute medical concerns. Never delay seeking or disregard professional medical advice because of something you read through our Services.

See our full Medical Disclaimer for more information.

Request Parameters

Parameter Type Required Description
symptom string Yes Symptom to find remedies for (e.g., "Headache")
approach string No Specific approach type (e.g., "comprehensive", "dietary", "herbs")

Example Request

{ "symptom": "Headache", "approach": "comprehensive" }

Example Response

{ "success": true, "data": { "symptom": "Headache", "remedies": [ { "name": "Peppermint Oil Massage", "source": "Herbal", "ingredients": [ {"name": "Peppermint Oil", "amount": "2-3 drops"} ], "preparation": ["Dilute with a carrier oil", "Massage onto temples"], "usage": "Apply every 4-6 hours", "warnings": ["Avoid eye contact", "Test for skin sensitivity"] } ], "dietary_approach": { "overview": "Dietary adjustments can help prevent headaches by stabilizing blood sugar and reducing inflammation.", "recommendations": [ "Stay hydrated with at least 2-3 liters of water daily", "Reduce refined sugar and processed foods" ] } } }

Code Examples

JavaScript / Node.js

const fetch = require('node-fetch'); const apiKey = 'your_api_key_here'; const url = 'https://yourdomain.com/api/fitness/food-ingredient'; const requestData = { "ingredient": "Sugar" }; fetch(url, { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-API-Key': apiKey }, body: JSON.stringify(requestData) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));

Python

import requests api_key = 'your_api_key_here' url = 'https://yourdomain.com/api/fitness/food-ingredient' headers = { 'Content-Type': 'application/json', 'X-API-Key': api_key } request_data = { 'ingredient': 'Sugar' } response = requests.post(url, headers=headers, json=request_data) data = response.json() print(data)

Sample Nutritional Breakdown Visualization

Below is an example of how the API's nutritional data (e.g., from /api/fitness/analyzeFoodPlate) could be visualized:

Sample Meal Nutrition Breakdown

Support

For additional help, contact support at support@thrivexdna.com.

Terms of Service

Last Updated: March 26, 2025

1. Agreement to Terms

These Terms of Service ("Terms") constitute a legally binding agreement made between you and Thrive X DNA Fitness API ("we," "us," or "our") concerning your access to and use of our fitness and nutrition API services ("Services"). By accessing or using our Services, you agree to be bound by these Terms. If you disagree with any part of these Terms, you may not access the Services.

2. Modifications to Terms

We reserve the right to modify these Terms at any time. We will provide notice of any material changes by posting the updated Terms on this page with a new "Last Updated" date. Your continued use of the Services after such modifications constitutes your acceptance of the modified Terms.

3. API Use and Limitations

Our Services provide programmatic access to fitness and nutrition data through our API. Your use of our API is subject to these Terms and the rate limits associated with your subscription tier. You agree not to:

  • Use our Services for any illegal purpose
  • Attempt to bypass rate limits or authentication mechanisms
  • Reverse engineer our Services
  • Sell, lease, share, or provide direct access to our API credentials to any third party
  • Use our Services in a manner that could damage, disable, overburden, or impair our servers or networks

4. Intellectual Property

Our Services, including all content, features, and functionality, are owned by us or our licensors and are protected by intellectual property laws. You may not duplicate, copy, or reuse any portion of the HTML, CSS, JavaScript, visual design elements, or concepts without express written permission.

5. User Content

By uploading images or other content to our Services, you grant us a non-exclusive, royalty-free, worldwide license to use, store, and display that content for the purpose of providing our Services. You are solely responsible for all data, information, and content you submit through our Services.

6. Termination

We may terminate or suspend your access to our Services immediately, without prior notice or liability, for any reason whatsoever, including, without limitation, if you breach these Terms. All provisions which by their nature should survive termination shall survive termination, including, without limitation, ownership provisions, warranty disclaimers, indemnity, and limitations of liability.

7. Governing Law

These Terms shall be governed by and construed in accordance with the laws of the state of Delaware, without regard to its conflict of law principles.

8. Dispute Resolution

Any dispute arising from or relating to these Terms or our Services will first be resolved through good-faith negotiations. If such negotiations fail, the dispute shall be resolved through binding arbitration conducted in Delaware.

Privacy Policy

Last Updated: March 26, 2025

1. Information We Collect

We collect information you provide directly to us when using our Services, including:

  • Account information (name, email address, billing information)
  • API usage data (request logs, IP addresses, usage timestamps)
  • User-provided content (food images, health metrics, fitness goals)
  • Device information (browser type, operating system, device type)

2. How We Use Your Information

We use the information we collect to:

  • Provide, maintain, and improve our Services
  • Process transactions and send related information
  • Monitor and analyze usage patterns and trends
  • Send technical notices, updates, security alerts, and administrative messages
  • Respond to customer service requests and support needs

3. Data Retention

We retain user data for as long as your account is active or as needed to provide Services. We may retain certain data as necessary to comply with our legal obligations, resolve disputes, or enforce our agreements.

4. Data Security

We implement appropriate technical and organizational measures to protect the security of your personal information. However, no method of transmission over the Internet or electronic storage is 100% secure, and we cannot guarantee absolute security.

5. Third-Party Services

Our Services may integrate with or contain links to third-party websites or services. We are not responsible for the practices employed by these third parties, and we encourage you to read their privacy policies.

6. Children's Privacy

Our Services are not directed to children under 13, and we do not knowingly collect personal information from children under 13. If you believe we may have collected information from a child under 13, please contact us immediately.

7. Your Rights

Depending on your location, you may have certain rights regarding your personal information, including the right to access, correct, delete, restrict, or object to our processing of your data. To exercise these rights, please contact us at privacy@thrivexdna.com.

8. Changes to this Privacy Policy

We may update this Privacy Policy from time to time. We will notify you of any changes by posting the new Privacy Policy on this page with a new "Last Updated" date.

Subscription Terms

Last Updated: March 26, 2025

1. Subscription Plans

We offer various subscription plans with different features, limitations, and pricing as described on our website. By subscribing to our Services, you agree to the terms and conditions outlined in these Subscription Terms.

2. Billing and Payments

When you subscribe to a paid plan, you agree to pay all applicable fees as described at the time of subscription. Subscription fees are billed in advance on a monthly basis. All payments are processed through our third-party payment processor, Stripe.

For plans that include a limited number of API requests, exceeding this limit will result in additional charges at the per-request rate specified in your plan. These additional charges will be billed at the end of your billing cycle.

3. Subscription Term and Renewal

Your subscription will automatically renew each month until you cancel. You may cancel your subscription at any time through your account settings or by contacting our customer support. Cancellation will be effective at the end of your current billing period.

4. Changes to Pricing and Plans

We reserve the right to change our subscription plans and pricing at any time. For existing subscribers, price changes will take effect at the start of the next billing period. We will provide reasonable notice of any price changes by email or through our website.

5. Refunds

All subscription payments are non-refundable except where required by law. In exceptional circumstances, we may issue refunds at our sole discretion. No refunds will be provided for partial use or non-use of Services or for any unused API requests within your plan's limits.

6. Account Termination

We reserve the right to suspend or terminate your account and access to Services if:

  • You violate our Terms of Service
  • Your payment fails or is declined
  • We suspect fraudulent activity
  • You abuse or misuse our Services

Upon termination, your right to use the Services will cease immediately. If you wish to terminate your account, you may simply discontinue using the Services or contact us to request account deletion.

Medical and Health Disclaimer

Last Updated: March 26, 2025

The information provided through our Services, including workout plans, nutritional advice, meal plans, food analysis, and natural remedies, is for informational and educational purposes only. It is not intended to be a substitute for professional medical advice, diagnosis, or treatment.

1. Not Medical Advice

Our Services do not provide medical advice, diagnosis, or treatment. The content provided through our API, including nutritional information, workout plans, and remedies, should not be considered medical advice. Always seek the advice of your physician or other qualified health provider with any questions you may have regarding a medical condition.

2. No Professional-Client Relationship

Using our Services does not create a doctor-patient relationship, a dietitian-client relationship, or any other professional healthcare relationship.

3. Individual Results May Vary

Fitness and nutritional results may vary from person to person. The effectiveness of workout plans, nutritional advice, and other information provided through our Services depends on many factors, including individual physical condition, diet, discipline, and dedication.

4. Natural Remedies

The natural remedies and alternative approaches provided through our Services are based on traditional wisdom and available research. They are not FDA-approved treatments and should not be used as a replacement for conventional medical care. These approaches, especially for serious conditions like cancer, diabetes, heart disease, and other chronic or acute medical conditions, should be discussed with qualified healthcare providers.

5. Food and Ingredient Analysis

The food plate analysis and ingredient information provided through our Services are estimates based on available data and AI analysis. Actual nutritional content may vary based on specific brands, preparation methods, and other factors.

6. Health Risk Acknowledgment

Before starting any fitness program or making significant changes to your diet, consult with a qualified healthcare provider, especially if you have a health condition, are pregnant or nursing, or have other health concerns. Not all exercises or nutritional approaches are suitable for everyone.

7. Emergency Medical Situations

In case of a medical emergency, call your doctor or emergency services immediately. Do not rely on our Services for emergency medical needs.

BY USING OUR SERVICES, YOU ACKNOWLEDGE THAT YOU ARE DOING SO AT YOUR OWN RISK AND THAT NEITHER WE NOR ANY PERSONS ASSOCIATED WITH US SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES ARISING FROM YOUR USE OF OUR SERVICES OR YOUR RELIANCE ON INFORMATION PROVIDED THROUGH OUR SERVICES.

Data Security

Last Updated: March 26, 2025

1. Security Measures

We implement industry-standard security measures to protect your data, including:

  • Data encryption in transit (HTTPS/TLS) and at rest
  • Secure API authentication mechanisms
  • Regular security audits and vulnerability assessments
  • Infrastructure security controls and monitoring
  • Employee access controls and security training

2. API Key Security

Your API key is your credential for accessing our Services. You are responsible for maintaining the security of your API key and should:

  • Never share your API key publicly or with unauthorized persons
  • Store your API key securely in your application code or configuration
  • Implement proper access controls for any systems that use your API key
  • Notify us immediately if you believe your API key has been compromised

3. Data Processing

When processing your data, we follow these principles:

  • We process data only for the purposes specified in our Privacy Policy
  • We limit access to your data to authorized personnel only
  • We maintain records of our data processing activities
  • We process data in accordance with applicable data protection laws

4. Data Handling for Food Images

When you upload food images for analysis, we:

  • Process the images for the specific purpose of nutritional analysis
  • May temporarily store images to improve our service and for debugging
  • Do not use images for purposes beyond those stated in our Privacy Policy
  • Implement appropriate technical measures to protect image data

5. Third-Party Processors

We may use third-party processors to provide certain aspects of our Services. These processors are contractually bound to process data only as instructed by us and to maintain appropriate security measures.

6. Data Breach Procedures

In the event of a data breach that affects your personal information, we will:

  • Investigate the breach and take remedial actions
  • Notify affected users as required by applicable law
  • Cooperate with regulatory authorities as necessary
  • Take steps to prevent similar breaches in the future

7. User Responsibilities

While we implement security measures to protect your data, the security of your account also depends on you. We recommend that you:

  • Use strong, unique passwords for your account
  • Regularly check your account for suspicious activity
  • Keep your contact information up to date
  • Follow our security guidelines for API key management

Refund Policy

Last Updated: March 26, 2025

1. Subscription Payments

All subscription payments are generally non-refundable. When you subscribe to our Services, you agree to pay the subscription fees according to your selected plan. These fees are charged at the beginning of each billing cycle and are not refundable, even if you cancel your subscription mid-cycle.

2. Exceptional Circumstances

In exceptional circumstances, we may consider refund requests at our sole discretion. Such circumstances may include:

  • Technical issues that severely impacted your ability to use our Services
  • Unauthorized charges or billing errors
  • Service outages exceeding 24 continuous hours

To request a refund, please contact our customer support team at support@thrivexdna.com with details of your request, including your account information and the reason for seeking a refund.

3. Additional Charges

Additional charges incurred for exceeding your plan's API request limits are not refundable. These charges represent actual usage of our Services beyond your subscription plan's allocation.

4. Cancellation Policy

You may cancel your subscription at any time through your account settings or by contacting our customer support team. Cancellation will be effective at the end of your current billing period, and you will continue to have access to your subscription until that time. No partial refunds will be issued for the remaining unused portion of your billing period after cancellation.

5. Free Trial Conversions

If we offer a free trial period and you convert to a paid subscription, you will be charged at the beginning of your first paid billing cycle. If you cancel during the free trial, you will not be charged.

6. Account Termination

If your account is terminated for violation of our Terms of Service or other policies, you will not be eligible for a refund of any fees paid.

7. Processing of Refunds

If a refund is approved, it will be processed using the same payment method used for the original purchase. Refunds may take 5-10 business days to appear on your statement, depending on your payment provider.

8. Changes to Refund Policy

We reserve the right to modify this Refund Policy at any time. Any changes will be effective upon posting the updated policy on our website with a new "Last Updated" date.