Developer API

The Archetype Engine,
As an API

White-label access to 8os archetype calculation. One POST request returns a full personality profile, compatibility scores, timing windows, and actionable insights. Production-ready. Starts free.

$0.001 per call
99.9% uptime SLA
<200ms avg latency
REST + webhooks

Dead Simple Integration

One API call. Full archetype profile returned in <200ms.

javascript8os Archetype API — Quick Start
// Calculate an archetype from a birth date
const response = await fetch('https://api.8os.ai/v1/archetype', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    birth_date: '1990-03-15',
    birth_time: '14:30',        // optional
    birth_location: 'New York', // optional, improves accuracy
  }),
});

const data = await response.json();
// {
//   archetype: 'Commander',
//   element: 'Metal',
//   day_master: 'Geng Metal',
//   energy_profile: { strength: 0.82, adaptability: 0.65, ... },
//   luck_cycles: [...],
//   compatibility: { achiever: 0.91, creative: 0.73, ... },
//   insights: ['High drive periods: Q2, Q4 2025', ...]
// }

API Endpoints

MethodEndpointDescriptionCost
POST/v1/archetypeCalculate archetype from birth data1 credit
GET/v1/archetype/{id}Retrieve a cached archetype resultFree
POST/v1/compatibilityCompare two archetypes for compatibility score1 credit
POST/v1/timingGet optimal timing windows for a given archetype2 credits
GET/v1/insights/{archetype}Static archetype profile and characteristic dataFree
POST/v1/teamAnalyze team compatibility across multiple archetypes5 credits

Full API reference, SDK libraries (Node.js, Python, Go), and Postman collection available after sign-up.

What Are Developers Building?

💕

Dating Apps

Surface archetype compatibility scores between matches. Users with matching elements report 2.3× more conversations.

⭐

Astrology Apps

Enrich your existing Western astrology with BaZi depth. Add 8os as a second layer to birth chart analysis.

🏢

HR Platforms

Predict team dynamics, optimal role fit, and leadership potential from archetype profiles.

🌿

Wellness Apps

Personalize recommendations — diet, sleep, exercise — based on elemental profile and energy cycles.

API Pricing

Pay As You Go

$0.001per API call

No monthly commitment. Pay only for what you use. Great for low-volume or testing.

  • ✓ All API endpoints
  • ✓ $0.001 per archetype calculation
  • ✓ Free tier: 100 calls/month included
  • ✓ 99.9% uptime SLA
  • ✓ Standard rate limits (100 req/min)
  • ✓ Email support
Get API Key

Growth

$99per month

20,000 API calls/month included. Best for growing apps and startups.

  • ✓ 20,000 calls/month included
  • ✓ Overage: $0.001/call
  • ✓ Priority rate limits (500 req/min)
  • ✓ Webhook support
  • ✓ Usage dashboard
  • ✓ Email + Slack support
Start Growth
Most Popular

Scale

$499per month

100,000 calls/month included. White-label rights. For production apps at scale.

  • ✓ 100,000 calls/month included
  • ✓ Overage: $0.0008/call
  • ✓ White-label (remove 8os branding from output)
  • ✓ Custom archetype models available
  • ✓ Dedicated IP range
  • ✓ Priority support + SLA guarantee
  • ✓ Dedicated account manager
Start Scale

Enterprise

Customcontact us

On-premise deployment, custom models, and enterprise SLA for high-volume use cases.

  • ✓ Unlimited API calls
  • ✓ On-premise / private cloud option
  • ✓ Custom BaZi model training
  • ✓ HIPAA / SOC2 compliance options
  • ✓ Dedicated engineering support
Contact Sales

Start building in 2 minutes

Free tier includes 100 API calls/month. No credit card required to start.

Get Your Free API Key