millionways logo
API docs by Redocly

millionways Large Psychology Model API (3)

Download OpenAPI specification:

Max Weidemann: max@millionways.me

Welcome to the millionways LPM API

Unlock human-level understanding with the world’s first Large Psychology Model (LPM) — built to decode personality, motivation, and emotion from raw text and audio. Unlike sentiment analysis or generic LLM tagging, this API delivers psychologically validated insights grounded in over a decade of proprietary scientific research.

API Usage

The main usage of this API is to categorize text and audio content into deep, explainable personality insights. The following main endpoints are available:

  • /categorize-text: Analyze text for personality insights.
  • /categorize-audio: Analyze audio content for personality insights.
  • /analyze-team: Input multiple profiles and receive team-level compatibility, synergy, and conflict analysis.
  • /chat: Interact with an emotionally intelligent chatbot powered by LPM insights.

For more detailed information on how to use these and the additional endpoints, please refer to the section below.

The response from these endpoints will be in JSON format and contain a comprehensive set of personality metrics, as well as texts describing the personality of the individual.

Authentication

  • apiKey (required): Your API key for authentication.

For your requests, you will need to provide your API key as a query parameter.

Example POST Request using cURL

curl -X POST "https://api.millionways.org/categorize-text?apiKey=your-api-key" -H "Content-Type: application/json" -d '{
    "text": "This is the text to be analyzed for personality metrics",
    "language": "en"
}'

Personality Metrics

Backed by PSI theory, our model detects patterns most AI systems can’t see. You’ll receive metrics across four core psychological domains:

  • Motives: Deep motivational drivers (Achievement, Power, Contact, and Zero)
  • Emotions: Approach vs. Avoidance dynamics
  • Cognitive Preferences: Energy orientation, perception style, decision-making approach, and Attitude towards the outside World.
  • Levels: Inspired, Creative, Adaptive, Tenacious, or Passive states

Each response includes an optional narrative personality summary based on these metrics, suitable for use in user profiles, dashboards, or assessments.

Tailored Outputs & Enterprise Adaptability

millionways’ LPM is not a one-size-fits-all tool—it can be adapted for specific verticals including hiring, sales, mental health, customer analytics, and fraud detection. For tailored API solutions, enterprise licensing, or integration support, contact us at millionways.me.

To understand the scientific foundation of our system, we encourage you to read more about PSI-Theory, the basis for our LPM.

Get call by id

Get call by id

path Parameters
callId
required
string
query Parameters
apiKey
required
string

Responses

Response samples

Content type
application/json
{
  • "call": {
    }
}

User Management

Get all users

Get all users

query Parameters
apiKey
required
string

Responses

Response samples

Content type
application/json
{
  • "users": [
    ]
}

Get user by id

Get user by id

path Parameters
userId
required
string
query Parameters
apiKey
required
string

Responses

Response samples

Content type
application/json
{
  • "user": {
    }
}

Get user analysis by id

Get user analysis by id

path Parameters
userId
required
string
query Parameters
apiKey
required
string

Responses

Response samples

Content type
application/json
{
  • "user": {
    }
}

Get user chats by id

Get user chats by id

path Parameters
userId
required
string
query Parameters
apiKey
required
string

Responses

Response samples

Content type
application/json
{
  • "user": {
    }
}

Create a new user

Create a new user

query Parameters
apiKey
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "5f9f5f9f5f9f5f9f5f9f5f9f"
}

Text Classification

Generate millionways emotionally-intelligent AI Classification based on Text Input.

Generate millionways emotionally-intelligent AI Classification based on Text Input.

query Parameters
apiKey
required
string
Request Body schema: application/json
required
text
string

text input to be classified

language
string

language parameter, defaults to en

Responses

Request samples

Content type
application/json
{
  • "text": "I am feeling good today and I want to go outside and meet some people.",
  • "language": "en"
}

Response samples

Content type
application/json
{
  • "createdAt": "2020-10-28T12:00:00.000Z",
  • "text": "I am feeling good today and I want to go outside and meet some people.",
  • "result": {
    },
  • "levels": {
    },
  • "responses": {
    },
  • "candidateTexts": {
    }
}

Generate millionways emotionally-intelligent AI Team Classification based on Text Input.

Generate millionways emotionally-intelligent AI Team Classification based on Text Input.

query Parameters
apiKey
required
string
Request Body schema: application/json
required
text
string

text input to be classified

language
string

language parameter, defaults to en

Responses

Request samples

Content type
application/json
{
  • "text": "I am feeling good today and I want to go outside and meet some people.",
  • "language": "en"
}

Response samples

Content type
application/json
{
  • "createdAt": "2020-10-28T12:00:00.000Z",
  • "text": "I am feeling good today and I want to go outside and meet some people.",
  • "result": {
    },
  • "levels": {
    },
  • "teamTexts": {
    }
}

Generate millionways emotionally-smart AI Classification based on Text Input by User with userId

Generate millionways emotionally-smart AI Classification based on Text Input by User with userId

path Parameters
userId
required
string

User ID

query Parameters
apiKey
required
string
Request Body schema: application/json
required
text
string

text input to be classified

language
string

language parameter, defaults to en

Responses

Request samples

Content type
application/json
{
  • "text": "I am feeling good today and I want to go outside and meet some people.",
  • "language": "en"
}

Response samples

Content type
application/json
{
  • "createdAt": "2020-10-28T12:00:00.000Z",
  • "userId": "5f9f5b9b0b9b9c0017b5b0a5",
  • "result": {
    },
  • "levels": {
    },
  • "responses": {
    },
  • "candidateTexts": {
    },
  • "deviations": {
    }
}

Audio Classification

Generate millionways emotionally-smart AI Classification based on Audio Input

Generate millionways emotionally-smart AI Classification based on Audio Input

query Parameters
apiKey
required
string
Request Body schema: multipart/form-data
required
file
string <binary>

Responses

Response samples

Content type
application/json
{
  • "createdAt": "2020-10-28T12:00:00.000Z",
  • "text": "I am feeling good today and I want to go outside and meet some people.",
  • "result": {
    },
  • "levels": {
    },
  • "responses": {
    },
  • "candidateTexts": {
    }
}

Generate millionways emotionally-smart AI Classification based on Audio Input

Generate millionways emotionally-smart AI Classification based on Audio Input

path Parameters
userId
required
string

User ID

query Parameters
apiKey
required
string
Request Body schema: multipart/form-data
required
file
string <binary>

Responses

Response samples

Content type
application/json
{
  • "createdAt": "2020-10-28T12:00:00.000Z",
  • "userId": "5f9f5b9b0b9b9c0017b5b0a5",
  • "text": "I am feeling good today and I want to go outside and meet some people.",
  • "result": {
    },
  • "levels": {
    },
  • "responses": {
    },
  • "candidateTexts": {
    },
  • "deviations": {
    }
}

Chatbot

Generate emotionally intelligent chatbot response based on user input

Generate emotionally intelligent chatbot response based on user input

query Parameters
apiKey
required
string
Request Body schema: application/json
required
messages
Array of any

history of messages between user with the role 'user' and chatbot with the role 'assistant'

language
string

language parameter, defaults to en

Responses

Request samples

Content type
application/json
{
  • "messages": [
    ],
  • "language": "en"
}

Response samples

Content type
application/json
{
  • "response": "How are you feeling today?",
  • "result": {
    },
  • "levels": {
    }
}

Generate emotionally intelligent chatbot response based on user input

Generate emotionally intelligent chatbot response based on user input

path Parameters
userId
required
string

User ID

query Parameters
apiKey
required
string
Request Body schema: application/json
required
messages
Array of any

history of messages between user with the role 'user' and chatbot with the role 'assistant'

language
string

language parameter, defaults to en

Responses

Request samples

Content type
application/json
{
  • "messages": [
    ],
  • "language": "en"
}

Response samples

Content type
application/json
{
  • "createdAt": "2020-10-28T12:00:00.000Z",
  • "response": "How are you feeling today?",
  • "result": {
    },
  • "levels": {
    }
}

Generate emotionally intelligent chatbot response based on user input with given Result

Generate emotionally intelligent chatbot response based on user input with given Result

query Parameters
apiKey
required
string
Request Body schema: application/json
required
messages
Array of any

history of messages between user with the role 'user' and chatbot with the role 'assistant'

language
string

language parameter, defaults to en

object
object

Responses

Request samples

Content type
application/json
{
  • "messages": [
    ],
  • "language": "en",
  • "result": {
    },
  • "levels": {
    }
}

Response samples

Content type
application/json
{
  • "createdAt": "2020-10-28T12:00:00.000Z",
  • "response": "How are you feeling today?",
  • "result": {
    },
  • "levels": {
    }
}

Generate emotionally intelligent mental health support chatbot response based on user input with given Result

Generate emotionally intelligent mental health support chatbot response based on user input with given Result

query Parameters
apiKey
required
string
Request Body schema: application/json
required
messages
Array of any

history of messages between user with the role 'user' and chatbot with the role 'assistant'

language
string

language parameter, defaults to en

object
object

Responses

Request samples

Content type
application/json
{
  • "messages": [
    ],
  • "language": "en",
  • "result": {
    },
  • "levels": {
    }
}

Response samples

Content type
application/json
{
  • "createdAt": "2020-10-28T12:00:00.000Z",
  • "response": "How are you feeling today?",
  • "result": {
    },
  • "levels": {
    }
}

Generate emotionally intelligent chatbot streamed response based on user input with given Result

Generate emotionally intelligent chatbot streamed response based on user input with given Result

query Parameters
apiKey
required
string
Request Body schema: application/json
required
messages
Array of any

history of messages between user with the role 'user' and chatbot with the role 'assistant'

language
string

language parameter, defaults to en

object
object

Responses

Request samples

Content type
application/json
{
  • "messages": [
    ],
  • "language": "en",
  • "result": {
    },
  • "levels": {
    }
}

Response samples

Content type
application/json
{
  • "event": "string"
}

Text Summarization

Generate millionways emotionally-intelligent AI sales insights based on Text Input.

Generate millionways emotionally-intelligent AI sales insights based on Text Input.

query Parameters
apiKey
required
string
Request Body schema: application/json
required
text
string

text input to be classified

language
string

language parameter, defaults to en

Responses

Request samples

Content type
application/json
{
  • "text": "I am feeling good today and I want to go outside and meet some people.",
  • "language": "en"
}

Response samples

Content type
application/json
{
  • "conversion": 85,
  • "assist": "Recommended Assist: Offer a personalized product plan that is easy to follow and fits seamlessly into their busy lifestyle, emphasizing small, achievable goals to build confidence and consistency. Highlight the importance of a structured routine that aligns with their intrinsic motivation and preference for autonomy.",
  • "response": "Recommended Response: I understand how challenging it can be to find a routine that truly fits into your life. Let's work together to create a personalized plan that aligns with your specific goals and schedule, ensuring it's both effective and manageable. This way, you can feel confident and motivated without feeling overwhelmed.",
  • "interests": "Interests: personal development, fitness, structured routines, autonomy, creative solutions, holistic perception.",
  • "stay_away_from": "Stay away from: generic solutions, high-pressure tactics, overly complex routines, superficial interactions, leadership roles, uncertainty, improvisation."
}

Generate millionways emotionally-intelligent AI summary based on Text Input.

Generate millionways emotionally-intelligent AI summary based on Text Input.

query Parameters
apiKey
required
string
Request Body schema: application/json
required
text
string

text input to be classified

language
string

language parameter, defaults to en

Responses

Request samples

Content type
application/json
{
  • "text": "I am feeling good today and I want to go outside and meet some people.",
  • "language": "en"
}

Response samples

Content type
application/json
{
  • "text": "I am feeling good today and I want to go outside and meet some people.",
  • "result": {
    },
  • "levels": {
    },
  • "response": "Example summary text"
}