「性格診断API」は、テキストからその書き手の人柄・性格・心理を診断するAPIです。 日本語テキストに特化し、自然言語処理技術や洗練された統計手法で診断を行います。

【ご試用版】

登録は、下記サービスから行っていただけます。
「ツイ性格診断」サービス https://twipersonality-app.metadata.tokyo/
こちらのSign Upリンクより登録を行い、「ユーザー情報」画面で「APIキーを発行」ボタンをクリックすることで数秒で発行されます。
ツイ性格診断サービス自体の操作については、こちらをご覧ください。

ツイ性格診断サービスに利用登録をすると、サービスをお使いいただけるようになるのと同時に、
性格診断APIをご利用いただけます。

※このバージョンは商用にご提供できません。商用のご利用要望は別途お問い合わせください。

API呼び出しURL

POST形式：https://twipersonality-back.metadata.tokyo/analyzepa/csv?（パラメータ指定）

パラメータ　　説明
text　　　　　（必須）UTF8でURLエンコードした文字列。
　　　　　　　　　　　カンマ、改行の入った、CSV形式のテキスト
apikey　　　　（必須）APIキー
exist_header　textの内容にCSVヘッダーが有るかどうかを指定します。
 　　　　　　　あり(1) or なし(0) 。デフォルト値は0(なし)。
analyze_col　 textの内容について、何カラム目を対象とするかを
　　　　　　　 1オリジンの数値で指定します。
 　　　　　　　 "all"を指定すると全カラムを診断対象とします。
　　　　　　　 (exist_header=1の場合、カラム名で指定することも可能。） 
　　　　　　　 複数カラムをカンマ区切りで指定可能。
 　　　　　　　デフォルト値は"all"。 
パラメータ例：
{
　"text": "col1,col2,col3,col4\n,col1,col2,col3,col4\n..."
  "analyze_col": "all",
  "csv_header": "0",
} 
curlによる呼び出し例
curl （ご提供URL） -X POST -d '{apikey=（APIKEY）&text="1,今日はいい天気だ。\n2,赤い車が欲しい。赤い色が大好きなので。" }'

出力形式

json形式です。ビッグファイブおよびその下位カテゴリとなるファセットについて、入力のテキストからスコアを算出し、percentile値を出力します。

<{
   "personality": [
     {
       "trait_id": "big5_openness",
       "name": "Openness",
       "category": "personality",
       "percentile": 0.8011,
       "significant": true,
       "children": [
         {
           "trait_id": "facet_adventurousness",
           "name": "Adventurousness",
           "category": "personality",
           "percentile": 0.8975,
           "significant": true
         },
         . . .
       ]
     },
   {
      big5それぞれを出力
   },
   "needs": [　※次verで実装予定
     {
       "trait_id": "need_challenge",
       "name": "Challenge",
       "category": "needs",
       "percentile": 0.6736,
       "raw_score": 0.7519,
       "significant": true
     },
     . . .
   ],
   "values": [　※次verで実装予定
     {
       "trait_id": "value_conservation",
       "name": "Conservation",
       "category": "values",
       "percentile": 0.8926,
       "raw_score": 0.7213,
       "significant": true
     },
     . . .
   ],
   . . .
 }

ビッグファイブの詳細、５つの要素とファセットについてはこちらを参照ください。
ja.Wikipedia.org/wiki/ビッグファイブ(心理学)