API Documentation
StellarScript B2B API - personality analysis & compatibility matching
StellarScript API
A B2B API service that delivers an individual's personality traits, fortune trends, and interpersonal compatibility as quantified data based on date of birth.
Quick Start
Use Cases by Industry
Dating / Matching
Compatibility-based matching, relationship type analysis, optimal partner recommendation
HR / Recruiting
Team composition optimization, collaboration compatibility, personality-based interview guides
Marketing / Commerce
Customer segmentation, personalized recommendations, campaign targeting
AI / Chatbots
Personalized conversation styles, tailored response strategies
Gaming / Entertainment
Character creation, story personalization, fortune content
All APIs support both solar and lunar calendars.
{
"birthInfo": {
"birthDate": "1990-05-15",
"birthTime": "14:30",
"gender": "MALE",
"timezone": "Asia/Seoul",
"calendarType": "LUNAR",
"isLeapMonth": false
}
}API Endpoints
/profile/fullAnalyzes an individual's innate personality across 7 categories.
📊 Returned data
💡 Use cases
Identifies a client's personality to suggest an effective counseling approach.
Example: For a client with an "analytical" personality type, data- and logic-based explanations work best
Analyzes applicants' personalities to predict team chemistry.
Example: Match fields with high aptitude scores to the actual applied position
Recommends self-improvement content suited to the user's personality.
Example: Prioritize communication-skill content for users with low interpersonal scores
/profile/interactionGenerates a personalized system prompt for AI chatbot / counseling services.
📊 Returned data
💡 Use cases
Converses with a different tone and approach for each user.
Example: Lead with the conclusion for "direct" users, and with acknowledging emotions for "empathetic" users
Applies a feedback style suited to the student's personality.
Example: Provide feedback that acknowledges even small achievements for perfectionist students
Identifies the preferred communication style of VIP customers.
Example: Provide detailed data to analytical customers, and storytelling to emotional ones
/profile/consumerAnalyzes consumption tendencies for marketing and commerce services.
📊 Returned data
💡 Use cases
Prioritizes products that match the user's consumption tendencies.
Example: Limited-time discounts for impulse buyers, comparison information for planned buyers
Identifies segments with high responsiveness to marketing messages.
Example: Send new-product launch notifications first to trend-sensitive customers
Classifies customer groups based on consumption tendencies.
Example: Offer premium services to personality groups predicted to have high LTV
/profile/fortuneComing SoonAnalyzes fortune scores and trends across 5 major categories at a given point in time.
📊 Returned data
💡 Use cases
Provides personalized fortune information to users.
Example: Automatically generate content such as today's fortune and this month's lucky days
Encourages active matching during periods of good romantic luck.
Example: Push notification "Now is a great time to meet someone!" during a romantic-luck upswing
Recommends rest during periods of low health luck.
Example: Recommend stress-management content during a health-luck downturn
/compatibility/pairAnalyzes the compatibility of two people and classifies it by relationship type.
📊 Returned data
💡 Use cases
Shows the compatibility score and relationship characteristics of two users.
Example: Display as "82 points - two people who become more complete because they differ"
Generates a detailed compatibility report between members.
Example: Provide detailed scores such as emotional harmony, values, and growth potential
Predicts collaboration chemistry between team members.
Example: Recommend complementary combinations when forming project teams
/compatibility/matchFinds the best-matching candidate for one person from up to 50 people.
📊 Returned data
💡 Use cases
Determines recommendation order based on compatibility scores.
Example: Determine final ranking by compatibility score after general filtering
Automatically matches the most compatible partner among members.
Example: Send the 3 weekly best matches by email
Recommends mentor-mentee combinations with matching personalities.
Example: Prioritize mentors with high "growth partner" compatibility
Request Example
curl -X POST https://stellar-script.com/api/v1/b2b/profile/full \
-H "Authorization: Bearer ss_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"birthInfo": {
"birthDate": "1990-05-15",
"birthTime": "14:30",
"gender": "MALE",
"timezone": "Asia/Seoul"
}
}'Response Format
// Success response
{
"success": true,
"data": {
// Analysis result per endpoint
},
"meta": {
"requestId": "uuid-xxx",
"processingTimeMs": 234,
"billedAmount": 2,
"endpoint": "/api/v1/b2b/..."
}
}
// Error response
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The input format is invalid."
}
}Error Codes
VALIDATION_ERRORUNAUTHORIZEDFORBIDDENRATE_LIMITEDINTERNAL_ERROR