ホーム API/ツール API 言語解析

言語解析

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

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

    ■言語解析【Powered by goo】

    提供 : REST


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

    提供 : REST


    利用条件 : あり ※1

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

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

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

    固有表現抽出


    • リクエストで送られた日本語文字列から、人名や地名、日付表現などの固有表現を抽出します。

      例えば、”鈴木さんがきょうの9時30分に横浜に行きます。”という文字列からは、人名として”鈴木”、地名として”横浜”, 日付表現として”きょう”、時刻表現として”9時30分”がそれぞれ抽出されます。

      このほかにも”○○株式会社”といった組織名や、”△△ビル”といった固有物名を抽出可能です。

      このAPIを用いることにより、最近1週間のSNS上の投稿のなかで話題になっているスポットを発見するといった分析を行うことが容易になります。

    リクエストURL

    • 法人情報登録者専用

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

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

    • 一般開発者用

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

    メソッド : 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 解析対象テキストを指定。
    class_filter - 固有表現種別フィルタは、下記のいずれかを指定。
    複数指定する場合は、”|”で区切って指定。
    人工物名 : ART
    組織名 : ORG
    人名 : PSN
    地名 : LOC
    日付表現 : DAT
    時刻表現 : TIM
    省略時は、全種別が指定される。

    レスポンスヘッダ

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

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

    キー 必須 説明
    request_id リクエスト時と同じリクエストIDを返却。
    class_filter - リクエスト時と同じ固有表現種別フィルタを返却。
    ne_list 固有表現リストを返却。固有表現リストは、表記・固有表現種別を要素として持つ固有表現情報の配列

    リクエストサンプル

    POST https://api.apigw.smt.docomo.ne.jp/gooLanguageAnalysisCorp/v1/entity?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    ※法人情報登録者専用のリクエストURLを使用しております。
    Content-Type: application/json
    {
     "request_id":"record001",
     "sentence":"鈴木さんがきょうの9時30分に横浜に行きます。"
    }

    レスポンスサンプル

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