ホーム 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/keyword

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

    メソッド : 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[タブ文字]リクエスト受付時刻[タブ文字]連番が指定される。
    title 解析対象タイトルを指定。
    body 解析対象本文を指定。
    max_num - 最大出力キーワード数を指定。
    省略時は、10が指定される。
    focus - 注目固有表現種別は、下記のいずれかを指定。
    組織名 : ORG
    人名 : PSN
    地名 : LOC
    省略時または上記以外の固有表現種別指定時は、全ての固有表現種別が同等に扱われる。

    レスポンスヘッダ

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

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

    キー 必須 説明
    request_id リクエスト時と同じリクエストIDを返却。
    focus - リクエスト時と同じ注目固有表現種別を返却。
    keywords スコアを要素として持つキーワードの配列として、キーワードリストを返却。

    リクエストサンプル

    POST https://api.apigw.smt.docomo.ne.jp/gooLanguageAnalysisCorp/v1/keyword?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    Content-Type: application/json
    {
     "request_id":"record001",
     "title":"docomo Developer supportのご紹介",
     "body":"株式会社NTTドコモやパートナー企業が持つ様々なアセットを「API」として汎用化して提供し、開発者へ展開することで、新たな事業の創出を推進する協創プラットフォームです。",
     "max_num":3,
     "focus":"ORG"
    }

    レスポンスサンプル

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