How do I use the Crystal API?

Explore the functions of the Crystal API below (enterprise accounts only).

Table of Contents

Overview

The Crystal API is currently available for enterprise accounts only. 

Activate your Token

Please contact your Customer Success Manager for your API token. 

Getting Started

Every request requires this header:

Authorization: Bearer YOUR_TOKEN

People API

The People API enables you to access all of the personality profiles associated with anyone on your Crystal team. This includes coworkers, candidates, and customers profiles. Team administrators can use this data to create integrations to your own internal database or CRM.

GET /v1/people

Query Parameters:

query: string - filters people by name or email address

Response:

"content": {
"profile": {
"overview": [
"This person tends to be persuasive and independent, taking frequent calculated risks and sometimes disregarding existing structures entirely.",
"This person tends to be a quick thinker, ambitious, persuasive, resistant to formal structure, and drawn to calculated risks.",
"This person tends to communicate directly and make decisions independently, sometimes disregarding existing structures or standards.",
"This person tends to be bold and direct in communication, favoring the big picture over details and swift action over analysis.",
"This person tends to be an enthusiastic adventurer: resentful of formal structures but serious and decisive in execution."
]
},
"behavior": {
"phrase": [
"Immediately projecting assertiveness and confidence",
"Driving others to action",
"Building and maintaining momentum",
"Completing projects more quickly than others",
"Saying something bluntly without details"
]
},
"motivation": {
"phrase": [
"Making quick decisions",
"Ambitious goals",
"Opportunities to advance",
"Taking charge",
"Leading others"
]
},
"drainer": {
"phrase": [
"Failing to achieve goals",
"Deep research and analysis",
"Over-planning",
"Keeping their opinion to themselves",
"Slow, drawn-out events"
]
},
"communication": {
"phrase": [
"Avoid being quiet or reserved",
"Keep conversation brief",
"Let them take the lead",
"Don't be afraid to disagree",
"Share a compelling story"
]
},
"meeting": {
"phrase": [
"Make an effort to meet their goals",
"Prepare for pushback",
"Send a bulleted list with anything they needs to prepare",
"Quickly address the purpose of the meeting",
"Crack a few jokes"
]
},
"selling": {
"phrase": [
"Ask about their goals",
"Project confidence",
"Break your pitch up into bite-sized chunks",
"Make an effort to focus the conversation",
"Keep the discussion high-level"
]
},
"working_together": {
"phrase": [
"Always focus on the team's overall goal",
"Stay focused on the bottom line",
"Implement good ideas quickly",
"Give them a chance to take charge",
"Don't be afraid to take risks"
]
}
},

Text Analysis API

The Text Analysis API enables you to generate DISC-based personality predictions from a single block of text, associated with a single author. The text block may include details from a resume, social media profile, CRM contact record, or aggregated set of tags from a contact-enrichment provider. 

GET /v1/analysis/text

Query Parameters:

text: string - a block of text with labels from a resume and/or social media profile (like job titles, experiences, interests, skills, qualities, and bio).  

Response:

{
"data": {
"personalities": {
"disc_type": "C"
},
"images": {
"disc_map": "https://api.crystalknows.com/images/disc_map/11.png"
},
"content": {
"profile": {
"overview": [
"This person is likely very curious and prefers to tackle challenging, complex problems. ",
"This person tends to be direct in verbalizing concerns without leaving anything up for interpretation, occasionally being blunt with feedback.",
"This person is often intrigued by complex problems that require a comprehensive, precise solution in order to be solved.",
"This person is primarily driven by logic: accurate, task-oriented, cautious, and logical decision-making.",
"This person tends to be a problem solver who values logic, reason, and debate. "
]
},
"behavior": {
"phrase": [
"Having a well-organized area",
"Making decisions based on logical analysis",
"Experimenting with many solutions to a problem",
"Providing clear expectations and guidelines",
"Enjoying thorough spreadsheets"
]
},
"motivation": {
"phrase": [
"Accuracy & precision",
"Fixing problems",
"Order and organization",
"Being correct",
"Finding the best possible outcome"
]
},
"drainer": {
"phrase": [
"Meeting lots of new people at once",
"Major or unexpected change",
"Unreliable, unproven information",
"When people disregard the rules",
"Dealing with emotionally charged issues"
]
},
"communication": {
"phrase": [
"Start conversations with an issue to resolve",
"Provide your reasoning before you get to the bottom line",
"Remain logical and objective",
"Ask lots of questions to keep their attention",
"Trust that they will follow specific verbal instructions"
]
},
"meeting": {
"phrase": [
"Take time to thoroughly explain your idea",
"Focus solely on the topic at hand",
"Answer every question as precisely as possible",
"Do your homework before a meeting",
"Schedule your meetings at a precise time"
]
},
"selling": {
"phrase": [
"Make sure you're prepared for tough questions",
"Explain how your product works",
"Speak with clarity and specificity",
"Present proven facts and statistics instead of stories",
"Ask them what problem they is trying to solve"
]
},
"working_together": {
"phrase": [
"Demonstrate your expertise",
"Count on them to keep things on track",
"Recognize and trust his skill",
"Set clear expectations",
"Allow your ideas to be put to the test"
]
}
}
}
}