ホーム API API 言語解析

言語解析

    言語解析APIは、日本語文字列に対し様々な解析機能を提供するAPIです。

    言語解析API利用イメージ
    API
    基本情報

    ■言語解析【Powered by goo】

    提供 : REST


    ■言語解析【Powered by Jetrunテクノロジ】

    提供 : REST


    利用条件 : あり ※1

    ※1「ガイドライン(必読)」に記載の利用条件に予め同意していただく必要がございます。

    ご利用いただくためには「アカウント登録(無料)」が必要です。

    リファレンスを参照するAPI機能名を選択してください

    カテゴリ分析


    • 入力文からキーワード取得とカテゴリ分析を行い、文全体のカテゴリ分布を返します。

    リクエストURL

    https://api.apigw.smt.docomo.ne.jp/truetext/v1/clusteranalytics

    メソッド : POST
    文字コード : UTF-8

    リクエストヘッダ

    キー 必須 説明
    Content-Type 送信データのMIMEタイプは、下記を指定。
    application/x-www-form-urlencoded

    リクエストクエリパラメータ

    キー 必須 説明
    APIKEY APIにアクセスするアプリの認証に利用する

    リクエストボディ

    キー 必須 説明
    text 解析対象の文字列を指定。URLエンコードする必要あり(UTF-8)。
    1リクエストにつき最大500文字まで(URLエンコード前のデータ長)
    extflg -

    一般ワード除外フラグ

    0:デフォルト値

    1:一般名詞に対しては返答しない

    レスポンスヘッダ

    キー 必須 説明
    Content-Type 受信データのMIMEタイプは、下記を返却。
    application/json;charset=UTF-8

    レスポンスボディ(JSON形式)

    キー 必須 説明
    status 解析が成功したか否かの判別。OKで解析成功、NGで失敗
    count 構文解析で取得された全体のカテゴリ数
    rawdata 解析対象文
    clusters 集計されたカテゴリ情報の組。最大5件までの返却
    cluster 集計されたカテゴリ情報群
    cluster_name カテゴリ名称
    cluster_rate カテゴリ含有率
    cluster_rank

    カテゴリランキング

    ※含有率が同一の場合は同じ順位になります。


    リクエストサンプル

    POST https://api.apigw.smt.docomo.ne.jp/truetext/v1/clusteranalytics?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    Content-Type: application/x-www-form-urlencoded
    text=%e6%98%a8%e6%97%a5%e3%81%af%e9%9a%85%e7%94%b0%e5%b7%9d%e8%8a%b1%e7%81%ab%e5%a4%a7%e4%bc%9a%e3%82%92%e8%a6%8b%e3%81%ab%e8%a1%8c%e3%81%a3%e3%81%a6%e3%81%8d%e3%81%be%e3%81%97%e3%81%9f%e3%80%82%e5%9c%b0%e4%b8%8b%e9%89%84%e3%81%ae%e6%b5%85%e8%8d%89%e9%a7%85%e3%81%a7%e9%99%8d%e3%82%8a%e3%81%9f%e7%9e%ac%e9%96%93%e3%81%8b%e3%82%89%e3%80%81%e5%a4%a7%e6%b7%b7%e9%9b%91%e3%81%97%e3%81%a6%e3%81%84%e3%81%be%e3%81%97%e3%81%9f%e3%80%82%e5%9c%b0%e4%b8%8a%e3%81%ab%e5%87%ba%e3%81%a6%e3%81%bf%e3%82%8b%e3%81%a8%e4%ba%ba%e6%b7%b7%e3%81%bf%e3%81%a8%e4%ba%a4%e9%80%9a%e8%a6%8f%e5%88%b6%e3%81%ae%e5%a4%9a%e3%81%95%e3%81%a7%e5%a4%a7%e8%8b%a6%e6%88%a6%e3%81%97%e3%81%be%e3%81%97%e3%81%9f%e3%81%8c%e3%80%81%e4%bd%95%e3%81%a8%e3%81%8b%e8%89%af%e3%81%84%e5%a0%b4%e6%89%80%e3%81%a7%e8%8a%b1%e7%81%ab%e3%82%92%e8%a6%8b%e3%82%8b%e3%81%93%e3%81%8c%e5%87%ba%e6%9d%a5%e3%81%be%e3%81%97%e3%81%9f%e3%80%82%e5%a4%8f%e3%81%ae%e9%a2%a8%e7%89%a9%e8%a9%a9%e3%80%81%e8%8a%b1%e7%81%ab%e3%82%92%e3%81%a9%e3%81%86%e3%81%9e%e3%81%8a%e6%a5%bd%e3%81%97%e3%81%bf%e3%81%8f%e3%81%a0%e3%81%95%e3%81%84

    レスポンスサンプル

    Content-Type: application/json;charset=UTF-8
    {
      "status":"OK",
      "count": 5 ,
      "rawdata": "昨日は隅田川花火大会を見に行ってきました。
                地下鉄の浅草駅で降りた瞬間から、大混雑していました。
                地上に出てみると人混みと交通規制の多さで大苦戦しましたが、
                何とか良い場所で花火を見るこが出来ました。
                夏の風物詩、花火をどうぞお楽しみください"
      "clusters"[
            {
              "cluster_name": "花火大会・祭り",
              "cluster_rate": 42,
              "cluster_rank": 1
            },
            {
              "cluster_name": "私鉄・地下鉄",
              "cluster_rate": 14,
              "cluster_rank": 2
            },
            {
              "cluster_name": "東京交通情報",
              "cluster_rate": 14,
              "cluster_rank": 2
            },
            {
              "cluster_name": "その他交通情報",
              "cluster_rate": 14,
              "cluster_rank": 2
            },
            {
              "cluster_name": "夜景・風物詩",
              "cluster_rate": 14,
              "cluster_rank": 2
            }
      ]
    }
    よくあるご質問
    APIなどの各サービスに関するよくある質問を掲載します。
    お問い合わせ
    「docomo Developer support」及び「作ろうスマートフォン/iモードコンテンツ」に関するお問い合わせです。よくあるご質問や技術ブログで解決しない場合は、お問い合わせください。