Help & Documentation
Learn how to use Smart Stacks, Smart Fuel, and other tools to optimize your health and fitness journey with evidence-based approaches.
API Documentation
Integrate Sighed Effects tools and data into your applications with our RESTful API. Access supplement data, calculations, and recommendations programmatically.
Getting Started
API Access
API access is currently in beta and available to select partners and developers. Full public API access will be available with premium memberships in the future.
Request API Access
To request API access for your project, contact our development team with details about your intended use case and integration requirements.
Request AccessBase URL
https://labs.sighedeffects.com/api/
Authentication
The API uses JWT (JSON Web Tokens) for authentication. Include your token in the Authorization header:
Authorization: Bearer your-jwt-token-hereAvailable Endpoints
Search & Data
Search Supplements
GETSearch supplements using fuzzy matching
GET /api/search-supplements?q=creatine
Advanced Search
GETSearch with multiple parameters and filters
GET /api/search-advanced?q=protein&category=muscle&limit=10
User Management
Get User Profile
GETRetrieve user profile and preferences
GET /api/members/profile
Update User Profile
PUTUpdate user profile information
PUT /api/members/profile
Calculations
TDEE Calculator
POSTCalculate Total Daily Energy Expenditure
POST /api/calculate/tdee
Generate Smart Stack
POSTGenerate personalized supplement recommendations
POST /api/stacks/generate
Request/Response Examples
TDEE Calculation Example
Request
{
"age": 30,
"gender": "male",
"weight": 180,
"height": 72,
"activity_level": "moderately_active",
"goal": "maintenance"
}Response
{
"bmr": 1890,
"tdee": 2605,
"goal_calories": 2605,
"macros": {
"protein": 180,
"carbs": 325,
"fat": 87
},
"calculation_id": "tdee_123456"
}Supplement Search Example
Request
GET /api/search-supplements?q=creatine&limit=3Response
{
"results": [
{
"id": 1,
"name": "Creatine Monohydrate",
"score": 95
},
{
"id": 2,
"name": "Creatine HCL",
"score": 87
}
],
"total_results": 2,
"low_confidence": false
}Error Handling
HTTP Status Codes
Error Response Format
{
"error": "Invalid input parameters",
"code": "VALIDATION_ERROR",
"details": {
"field": "age",
"message": "Age must be between 18 and 80"
}
}Rate Limits
Current Limits
- • Search endpoints: 100 requests per hour
- • Calculation endpoints: 50 requests per hour
- • User management: 20 requests per hour
- • All endpoints: 200 total requests per hour
Rate limits are per API key. Contact us if you need higher limits for your application.
SDKs and Libraries
Official SDKs and community libraries are in development. Currently, the API can be accessed using standard HTTP clients in any programming language.