ReadingFace API

Access personality subtype data programmatically

RESTful JSON API

Simple REST endpoints returning clean JSON data for all ReadingFace subtypes and relationships

No Authentication

Public read-only API for accessing ReadingFace knowledge base - no API key required

CORS Enabled

Access from any domain - perfect for client-side applications and research projects

Comprehensive Data

Complete subtype profiles, duality pairs, quadra relationships, and compatibility matrices

Overview

The ReadingFace API provides programmatic access to the complete ReadingFace personality compatibility system. Access data for all 32 subtypes, 16 duality pairs, 8 quadras, and the complete knowledge graph of relationships.

All endpoints return JSON data and support CORS for client-side access. No authentication is required for read operations.

Base URL

https://readingface.com/api/v1/

All API endpoints are relative to this base URL. The current API version is v1.

Available Endpoints

GET /subtypes.json

Returns complete data for all 32 ReadingFace subtypes including functions, energy patterns, and optimal matches.

Example Response

{
  "subtypes": [
    {
      "code": "ILE-Ne",
      "name": "Intuitive Explorer",
      "type": "ENTp",
      "quadra": "Alpha A",
      "block": "Inert",
      "optimal_dual": "SEI-Fe",
      "energy_increase": 78,
      "functions": {
        "leading": "Ne",
        "creative": "Ti",
        "role": "Se",
        "vulnerable": "Fi",
        "suggestive": "Si",
        "mobilizing": "Fe",
        "ignoring": "Ni",
        "demonstrative": "Te"
      },
      "enhanced": ["Ne", "Fi", "Fe", "Ni"],
      "subdued": ["Ti", "Se", "Si", "Te"]
    }
  ],
  "total": 32
}

GET /duality.json

Returns all 16 precision duality pairs with compatibility dynamics and energy exchange patterns.

Example Response

{
  "duality_pairs": [
    {
      "pair_id": "alpha-1",
      "subtype_1": "ILE-Ne",
      "subtype_2": "SEI-Fe",
      "quadra": "Alpha A",
      "name": "Explorer-Harmonizer",
      "energy_signature": "Bright, expansive, socially magnetic",
      "compatibility_score": 0.78,
      "dynamics": {
        "energy_flow": "Ne+ generates possibilities, Fe+ creates emotional validation",
        "conflict_resolution": "Swift repair through Fe dialogue and Ne reframing",
        "growth_pattern": "Mutual expansion of intellectual and emotional intelligence"
      }
    }
  ],
  "total": 16
}

GET /quadras.json

Returns data for all 8 subtype quadras including member subtypes and collective dynamics.

Example Response

{
  "quadras": [
    {
      "quadra_id": "alpha-a",
      "name": "Vibrant Collective",
      "traditional_quadra": "Alpha",
      "energy_signature": "Animated, welcoming, intellectually playful",
      "members": ["ILE-Ne", "SEI-Fe", "LII-Ti", "ESE-Si"],
      "duality_pairs": [
        {"pair": ["ILE-Ne", "SEI-Fe"]},
        {"pair": ["LII-Ti", "ESE-Si"]}
      ],
      "collective_role": "Intellectual communities with heart"
    }
  ],
  "total": 8
}

GET /knowledge-graph.json

Returns the complete ReadingFace knowledge graph with all relationships, compatibility scores, and system metadata.

Example Response

{
  "version": "1.0",
  "system": "ReadingFace",
  "nodes": {
    "subtypes": [...],
    "functions": [...],
    "quadras": [...]
  },
  "edges": {
    "duality": [...],
    "conflict": [...],
    "activity": [...],
    "mirror": [...]
  },
  "metadata": {
    "total_subtypes": 32,
    "total_duality_pairs": 16,
    "total_quadras": 8,
    "energy_increase_optimal": 0.78
  }
}

Rate Limits

⚠️ Rate Limiting

The API is rate limited to 100 requests per minute per IP address. If you exceed this limit, you'll receive a 429 status code. Please cache responses when possible.

Usage Examples

JavaScript Fetch

JavaScript

fetch('https://readingface.com/api/v1/subtypes.json')
  .then(response => response.json())
  .then(data => {
    console.log(`Found ${data.total} subtypes`);
    data.subtypes.forEach(subtype => {
      console.log(`${subtype.code}: ${subtype.name}`);
    });
  });

Python Requests

Python

import requests

response = requests.get('https://readingface.com/api/v1/subtypes.json')
data = response.json()

for subtype in data['subtypes']:
    print(f"{subtype['code']}: {subtype['name']}")
    print(f"  Optimal Dual: {subtype['optimal_dual']}")
    print(f"  Energy Increase: {subtype['energy_increase']}%")

cURL

curl -X GET "https://readingface.com/api/v1/subtypes.json" \
  -H "Accept: application/json"