ホーム API API 言語解析

言語解析

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

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

    ■言語解析【Powered by goo】

    提供 : REST


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

    提供 : REST


    利用条件 : あり ※1

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

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

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

    形態素解析


    • リクエストで送られた日本語文字列を、形態素と呼ばれる単語単位に分割します。

      例えば”この商品はデザインが斬新だ”という文字列は、”この”, “商品”, “は”, ”デザイン”, ”が”, ”斬新”, ”だ”というように分割されます。

      このAPIを用いることにより、自社製品のレビュー記事からどのような表現でよく評価されているかといった分析を行うことが容易になります。

    リクエストURL

    • 法人情報登録者専用

    https://api.apigw.smt.docomo.ne.jp/gooLanguageAnalysisCorp/v1/morph

    ※法人情報登録はこちらから無料で登録可能です。

    • 一般開発者用

    https://api.apigw.smt.docomo.ne.jp/gooLanguageAnalysis/v1/morph

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

    リクエストヘッダ

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

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

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

    リクエスト

    Content-Typeがapplication/x-www-form-urlencodedの場合、リクエストクエリパラメータに指定。

    Content-Typeがapplication/jsonの場合、リクエストボディに指定。

    キー 必須 説明
    request_id - リクエストIDを指定。
    省略時は、labs.goo.ne.jp[タブ文字]リクエスト受付時刻[タブ文字]連番が指定される。
    sentence 解析対象テキストを指定。
    info_filter - 形態素情報フィルタは、下記のいずれかを指定。
    複数指定する場合は、”|”で区切って指定。
    表記 : form
    形態素 : pos
    読み : read
    form|pos|read(省略時)
    pos_filter - 形態素品詞フィルタを指定。
    出力対象とする品詞を”|”で区切って指定。
    省略時は、全形態素が指定される。

    レスポンスヘッダ

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

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

    キー 必須 説明
    request_id リクエスト時と同じリクエストIDを返却。
    info_filter - リクエスト時と同じ形態素情報フィルタを返却。
    pos_filter - リクエスト時と同じ形態素品詞フィルタを返却。
    word_list 形態素リストを返却。
    形態素リストは文ごとに分かれた文単位形態素リストの配列となる。文単位形態素リストは形態素情報の配列で、形態素情報には表記・形態素・読みのうち形態素情報フィルタで指定された要素が含まれる。
    例)
    形態素リスト: [[["文"],["1つ"],["。"]],[["文"],["2つ"],["。"]]]
    文単位形態素リスト: [["文"],["1つ"],["。"]]
    形態素情報: ["文"]

    リクエストサンプル

    POST https://api.apigw.smt.docomo.ne.jp/gooLanguageAnalysisCorp/v1/morph?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    ※法人情報登録者専用のリクエストURLを使用しております。
    Content-Type: application/json
    {
     "request_id":"record001",
     "sentence":"日本語を分析します。",
     "info_filter":"form"
    }

    レスポンスサンプル

    Content-Type: application/json;charset=UTF-8
    {
     "request_id":"record001",
     "info_filter":"form",
     "word_list":[[["日本語"], ["を"], ["分析"], ["し"], ["ます"], ["。"]]]
    }
    よくあるご質問
    APIなどの各サービスに関するよくある質問を掲載します。
    お問い合わせ
    「docomo Developer support」及び「作ろうスマートフォン/iモードコンテンツ」に関するお問い合わせです。よくあるご質問や技術ブログで解決しない場合は、お問い合わせください。