Hi Developer!

Welcome to Traitify's Personality API! We understand that behind every user is a human being with a personality waiting to be discovered. With that in mind, we've created a diverse set of fun visual assessments used to uncover personality types and traits. Your users simply select "Me" or "Not Me" to a brief series of images and voila! Instant, actionable data.

With this psychology-backed data in hand, the possibilities are endless - any way that personalization can help you is now within reach. Potential uses include:

  • Applicant Fit Score
  • Personalized Job Recommendations
  • Personalized Interview Questions
  • Personality Conflicts / Complements
  • Communication Styles
  • Ideal Work Environments
  • Workplace Performance Predictions
  • Career Growth Hacks
  • Leadership Styles
  • Team Building Suggestions

Our variety of assessments allow for quick and fluid integration with any product. Traitify's pricing is designed to be flexible and cost effective.

Getting Started

Using Traitify's Personality API is very simple - at the most basic level you can embed one of our assessments into your website or application in about 5 minutes. This guide is here to help you get up and running as quickly as possible.

Of course, if you need help at any time, feel free to contact support.

Step 1: Create your account or Login

Sign up for a developer account or simply login to obtain your authorization keys.

Public Key: ********************abc123
Secret Key: ********************xyz789

Step 2: Get an Assessment Id from the Server

Open a Terminal window and paste the following command:

curl https://api.traitify.com/v1/assessments \
-H "Content-Type: application/json" \
-u ********************xyz789:x \
-d '{"deck_id": "career-deck"}'

Your result should look similar to this (this is just an example):

{"id":"fabd3932-ba75-4430-bd33-0b78202557cb","deck_id":"career
deck","tags":null,"completed_at":null,"created_at":1414601585988}

Step 3: Render your assessment

We've made this easy with our JavaScript widget. Simply include the JS library on your page, set a few variables and render the assessment as illustrated below. When the assessment is complete, we'll render the results.

<script src="https://cdn.traitify.com/js/v2/traitify.js"></script>
<script>
  Traitify.setHost("https://api.traitify.com");
  Traitify.setPublicKey("********************abc123");

  assessment = Traitify.ui.component();
  assessment.assessmentID("the assessment id from step 2");
  assessment.target("#the-id-of-the-target-you-wish-to-render-to");
  assessment.render();
</script>