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:

  • Matchmaking
  • Marketing / Sales
  • Curated Content
  • Recommendations
  • Human Resources Management
  • Personalized Experiences
  • Career Building
  • Behavior Predictions

Our variety of assessments allow for quick and fluid integration with any product.

Traitify's pricing is designed to be flexible and cost effective. Our API is completely free to try in Sandbox mode, with no setup fees associated - we only charge once you're ready to go live!

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 reach out to our development team.

Step 1: Create your account or Login

for a developer account or simply and everything will be all setup for you in the example below.

Public Key: ********************bt599q
Secret Key: ********************gtm05u

Step 2: Get an Assessment Id from the Server

Open a Terminal window and paste the following command:

curl https://api-sandbox.traitify.com/v1/assessments \
-H "Content-Type: application/json" \
-u ********************gtm05u: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, the callback function will be called and we'll render the results.

<html>
  <head>
    <script src="https://cdn.traitify.com/js/widgets/v1.js"></script>
  </head>
  <body>
    <div class="assessment"></div>
    <script>
      Traitify.setPublicKey("********************bt599q");
      Traitify.setHost("https://api-sandbox.traitify.com");
      Traitify.setVersion("v1");
      var assessmentId = 'your-assessment-id';
      Traitify.ui.load(assessmentId, ".assessment")
    </script>
  </body>
</html>