CINXE.COM

<!DOCTYPE HTML> <html lang="ja"> <head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb#"> <meta charset="utf-8">  <title>テキストペア類似度API ｜ソフト・アプリ開発のAPIなら【gooラボ】</title> <meta name="description" content="2つのテキストを比較し、その意味的な類似度を返却します"> <meta name="keywords" content="API,日本語,日本語検索,日本語解析,類似度,テキストペア類似度"> <meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=0"> <meta name="format-detection" content="telephone=no"> <meta property="og:site_name" content="gooラボ"> <meta property="og:title" content="テキストペア類似度API ｜ソフト・アプリ開発のAPIなら【gooラボ】"> <meta property="og:type" content="website"> <meta property="og:description" content="2つのテキストを比較し、その意味的な類似度を返却します"> <meta property="og:url" content="https://labs.goo.ne.jp/api/textpair_doc"> <meta property="og:image" content="https://labs.goo.ne.jp/wp-content/uploads/2014/11/keyvisual_topdays_API.png"> <meta property="fb:app_id" content="390341541124770"> <link rel="canonical" href="https://labs.goo.ne.jp/api/textpair_doc"> <link rel="stylesheet" href="https://u.xgoo.jp/css/1.7.css"> <link rel="stylesheet" href="https://labs.goo.ne.jp/wp-content/themes/goolab_3.0.0/css/style.css"> <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300"> <link rel="shortcut icon" href="https://u.xgoo.jp/favicon.ico"> <link rel="apple-touch-icon" href="https://u.xgoo.jp/favicon.ico"> </head> <body class="pc NR-col2a NR-rwd"> <div id="fb-root"></div> <script>(function(d, s, id) { var js, fjs = d.getElementsByTagName(s)[0]; if (d.getElementById(id)) return; js = d.createElement(s); js.id = id; js.src = "//connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.0"; fjs.parentNode.insertBefore(js, fjs); }(document, 'script', 'facebook-jssdk'));</script> <script> dataLayer = [{ 'template': 'pc', 'rwd': 1 }]; var u = navigator.userAgent; if((/android/i.test(u)&&/mobile/i.test(u))||(!/ipad/i.test(u)&&/ip(hone|od)/i.test(u))){ dataLayer[0].template = 'sp'; } </script>  <noscript><iframe src="//www.googletagmanager.com/ns.html?id=GTM-KKJ2HD" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript> <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src= '//www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','GTM-KKJ2HD');</script>  <div id="NR-page"> <header role="banner"><div id="NR-header"> <div id="NR-header-in"> <p id="NR-header-logo"> <a href="https://www.goo.ne.jp/" id="NR-header-logo-goo"><img src="https://u.xgoo.jp/img/goo.png" alt="goo" title="goo"></a><a href="https://labs.goo.ne.jp/" id="NR-header-logo-sv">ラボ<img src="https://u.xgoo.jp/img/sv/labs.png" alt="gooラボ" title="gooラボ"></a> </p> <div id="NR-header-util"> <ul id="NR-header-tool" class="cx"> <li><a href="https://www.goo.ne.jp/" class="NR-go">gooトップ</a></li> </ul> </div> </div> </div></header> <nav role="navigation"> <div id="NR-nav" class="nr_nav_btm"> <div id="NR-nav-main"> <ul id="NR-nav-main-in" class="cx"> <li><a href="/">トップ</a></li> <li><a href="/api/">API</a></li> <li><a href="/topic/">TOPIC</a></li> <li><a href="/service/">SERVICE</a></li> <li><a href="/sitemap/">SITEMAP</a></li> </ul> </div> </div></nav> <div id="NR-wrapper"> <nav role="navigation"> <div class="NR-tpath nav"> <ol class="cx"> <li class="NR-first" itemscope itemtype="http://data-vocabulary.org/Breadcrumb"><a href="/" itemprop="url"><span itemprop="title">gooラボ</span></a></li> <li itemscope itemtype="http://data-vocabulary.org/Breadcrumb"><a href="/api" itemprop="url"><span itemprop="title">API</span></a></li> <li>テキストペア類似度API</li> </ol> </div> </nav> <div id="NR-wrapper-in" class="cx"> <div id="NR-main"> <div id="NR-main-in"> <section><div id="single"> <div class="header_area"> <div class="category api"> <div>API</div> </div> <div class="title_area"> <h1>テキストペア類似度API</h1> <p class="date">2018/04/24</p> </div> </div> <section><div class="section">  <div id="single_body"> <h2>テキストペア類似度APIの概要</h2> <p>テキストペア類似度はリクエストで送られた２つのテキストを比較し、テキスト間の意味的な類似度を算出して返却します。</p> <p>例えば、<br> 1:高橋さんはアメリカに出張に行きました。<br> 2:山田さんはイギリスに留学している。<br> というように、どちらも「外国へ行っている」という意味のテキストを入力した場合、類似度は高く出力されます。</p> <p>逆に、<br> 1:今日の日経平均は大幅な続伸となりました。<br> 2:東京では珍しく雪が降りました。<br> というように、意味が異なるテキストを入力した場合、類似度は低く出力されます。</p> <p>これにより、２つのテキストにおける「意味的な近さ」を測る指標として利用する事が可能です。なお、類似度は0～1の範囲内で返却されますが、単純な比例による計算ではありません。意味が近しい場合は概ね0.6以上の類似度が出力されます。</p> <p>テキストペア類似度APIを用いることにより、表現が異なる文章の類似度を測る事ができるため、チャットボット・音声対話システム等において、ユーザー発話がどのような質問をしているのかを測り、条件分岐を行わせる事や、ユーザーからの質問が、既存のFAQ集と似た物が存在しないかを調べる検索システムの実現などへの応用が期待できます。</p> <h3>リクエスト先URL</h3> <p>https://labs.goo.ne.jp/api/textpair</p> <h3>リクエストパラメータ</h3> <p>application/json形式のみでのPOSTを受け付けます。<br> ※GETは受け付けませんのでご注意ください。</p> <table> <thead> <tr> <th>パラメータ名</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>app_id<br> (必須項目)</td> <td>アプリケーションID</td> </tr> <tr> <td>request_id</td> <td>リクエストID<br> 省略時は"labs.goo.ne.jp[タブ文字]リクエスト受付時刻[タブ文字]連番"となります。</td> </tr> <tr> <td>text1<br> （必須項目）</td> <td>1つ目の比較対象テキスト</td> </tr> <tr> <td>text2<br> （必須項目）</td> <td>2つめの比較対象テキスト</td> </tr> </tbody> </table> <h3>レスポンスパラメータ</h3> <p>JSONフォーマットのテキスト形式となります。<br> Content-typeは"application/json"となります。</p> <table> <thead> <tr> <th>パラメータ名</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>request_id</td> <td>リクエストと同じ値となります。</td> </tr> <tr> <td>score</td> <td>テキストペア類似度<br> 0～1の範囲の数値情報。0に近いほど類似度が低く、1に近いほど類似度が高い。ただし、単純比例では無いため、注意が必要。概ね0.6以上の数値である場合、類似度が高いと言える。</td> </tr> </tbody> </table> <h3>入出力サンプル</h3> <h4>入力例: Input sample</h4> <div class="grayArea">{"app_id":"[発行されたapp_id]", "request_id":"record007", "text1":"高橋さんはアメリカに出張に行きました。", "text2":"山田さんはイギリスに留学している。"}</div> <h4>出力例: Output sample</h4> <div class="grayArea">{"request_id": "record007", "score": 0.633348}</div> <p>APIを利用するための手順については<a href="/apiusage">こちら</a>で説明していますので、ぜひご活用ください。<br> 利用登録は<a href="/apiregister">こちら</a>からお願いします。</p> <p>当APIを活用したWEBサービス、アプリも歓迎致します。ご相談は<a href="https://support.ocn.ne.jp/personal/inquiry/detail/pid2200001tkb" target="_blank" rel="noopener noreferrer">こちら</a>からお問い合わせお願い申し上げます。</p> <section id="console_area"> <div class="console_header"> <h2 title="APIコンソール">APIコンソール</h2> <a class="bluebut small butclose" id="openshut_btn" href="javascript:void(0)">開く</a> </div> <div class="console_body" style="display: none"> <form id="consoleForm"> <table class="api_console_tbl"> <thead> <tr> <th>Parameter</th> <th class="wid60">value</th> <th>Type</th> </tr> </thead> <tbody> <tr> <td>app_id (Required)</td> <td><input type="text" id="app_id" name="app_id|string"></td> <td>string</td> </tr> <tr> <td>request_id</td> <td><input type="text" id="request_id" name="request_id|string"></td> <td>string</td> </tr> <tr> <td>text1 (Required)</td> <td><input type="text" id="text1" name="text1|string"></td> <td>string</td> </tr> <tr> <td>text2 (Required)</td> <td><input type="text" id="text2" name="text2|string"></td> <td>string</td> </tr> </tbody> </table> <input type="hidden" name="api_url" value="https://labs.goo.ne.jp/api/textpair"> <a class="bluebut" id="console_btn" href="javascript:void(0)">Try it!</a> </form> <hr class="border1"> <p> Request<br> <textarea rows="5" id="api_request" class="gray" style="width:95%;" readonly="readonly"></textarea> </p> <p> Result<br> <textarea rows="10" id="api_result" class="gray" style="width:95%;" readonly="readonly"></textarea> </p> </div> </section> <h2>日本語解析API一覧</h2> <div style="margin-left: 1em; text-indent: -1em;"><a href="https://labs.goo.ne.jp/api/2015/334/" target="_blank" rel="noopener noreferrer">■形態素解析API</a><br> 日本語文字列を、形態素と呼ばれる意味を持つ最小限の単語単位に分割します</div> <div style="margin-left: 1em; text-indent: -1em;"><a href="https://labs.goo.ne.jp/api/2015/336/" target="_blank" rel="noopener noreferrer">■固有表現抽出API</a><br> 日本語文字列から、人名や地名、日付表現などの固有表現を抽出します</div> <div style="margin-left: 1em; text-indent: -1em;"><a href="https://labs.goo.ne.jp/api/2015/338/" target="_blank" rel="noopener noreferrer">■ひらがな化API</a><br> 日本語文字列を、ひらがなもしくはカタカナによる記載に変換します</div> <div style="margin-left: 1em; text-indent: -1em;"><a href="https://labs.goo.ne.jp/api/2015/1321/" target="_blank" rel="noopener noreferrer">■キーワード抽出API</a><br> 人名や地名、組織など文書を特徴づけるキーワードを抽出します</div> <div style="margin-left: 1em; text-indent: -1em;"><a href="https://labs.goo.ne.jp/api/2016/1554/" target="_blank" rel="noopener noreferrer">■時刻情報正規化API</a><br> 時刻情報となる部分を抽出しそれらを正規化した値を生成します</div> <div style="margin-left: 1em; text-indent: -1em;"><a href="https://labs.goo.ne.jp/api/textpair_doc" target="_blank" rel="noopener noreferrer">■テキストペア類似度API</a><br> 2つのテキストを比較し、その意味的な類似度を返却します</div> <div style="margin-left: 1em; text-indent: -1em;"><a href="https://labs.goo.ne.jp/api/jp/slot-value-extraction/" target="_blank" rel="noopener noreferrer">■スロット値抽出API</a><br> スロット値抽出APIを利用すると、氏名、生年月日などの基本的な情報を簡単に抽出できます</div> </div> </div></section> </div></section> <div class="navLinkContainer"> <div class="navLink"> <a href="https://labs.goo.ne.jp/api/en/slot-value-extraction/" rel="next">前のページ</a> <a href="https://labs.goo.ne.jp/api/jp/slot-value-extraction/" rel="prev">次のページ</a> </div> </div> </div> </div> <div id="NR-sub"> <div id="NR-sub-in"> <aside role="complementary"><div id="toAbout"> <a class="bluebut wide btm10" href="/about/" title="gooラボとは">gooラボとは</a> </div></aside> <aside role="complementary"><div id="toUsage"> <a class="bluebut wide btm10" href="/apiusage/" title="gooラボAPI利用方法">APIご利用の流れ</a> </div></aside> <aside role="complementary"><div id="toTerm"> <a class="bluebut wide btm10" href="/apiterm/" title="gooラボAPI利用規約">gooラボAPI利用規約</a> </div></aside> <aside role="complementary"><div id="toContact"> <a class="bluebut wide btm30" href="https://support.ocn.ne.jp/personal/inquiry/detail/pid2200001tkb" title="gooラボへのお問い合わせ">お問い合わせ</a> </div></aside> <aside role="complementary"><div id="news_area" class="rightbox"> <div class="gradientbox_right"> <h3 title="API">API</h3> </div> <div class="unit"> <ul> <li><a href="/api/textpair_doc">テキストペア類似度API公開しました</a></li> <li><a href="/api/jp/slot-value-extraction/">スロット値抽出API公開しました</a></li> <li><a href="/api/jp/time-normalization/">時刻情報正規化API公開しました</a></li> <li><a href="/api/jp/keyword-extraction/">キーワード抽出API公開しました</a></li> <li><a href="/api/jp/named-entity-extraction/">固有表現抽出API公開しました</a></li> <li><a href="/api/jp/morphological-analysis/">形態素解析API公開しました</a></li> <li><a href="/api/jp/hiragana-translation/">ひらがな化API公開しました</a></li> </ul> </div> </div></aside> <aside><div class="facebook" style="background-color: #FFF; margin-bottom: 10px;"> <div class="fb-like-box" data-href="https://www.facebook.com/labs.goo" data-colorscheme="light" data-show-faces="true" data-header="false" data-stream="false" data-show-border="false"></div> </div></aside> </div> </div> </div>  </div> <footer role="contentinfo"><div id="NR-footer"> <div id="NR-footer-in"> <div id="NR-footer-sv"> <dl id="NR-footer-sv-site"> <dt><a href="#">gooラボ</a></dt> <dd> <ul> <li><a href="/api/">API</a></li> <li><a href="/topic/">TOPIC</a></li> <li><a href="/service/">SERVICE</a></li> <li><a href="/sitemap/">サイトマップ</a></li> <li><a href="/about/">gooラボとは</a></li> </ul> </dd> </dl> </div> <div id="NR-footer-link"> <ul> <li><a href="https://www.goo.ne.jp/">gooトップ</a></li> <li><a href="https://www.goo.ne.jp/sitemap/">サイトマップ</a></li> <li><a href="https://www.goo.ne.jp/set/">スタートページに設定</a></li> <li><a href="https://www.goo.ne.jp/rss/">RSS</a></li> <li><a href="https://advertising.nttr.co.jp/adinfo/">広告掲載</a></li> <li><a href="https://help.goo.ne.jp/office/agreement.html">免責事項</a></li> <li><a href="https://www.docomo.ne.jp/utility/privacy/">プライバシーポリシー</a></li> <li><a href="https://help.goo.ne.jp/">ヘルプ</a></li> <li><a href="https://www.docomo.ne.jp/corporate/">企業情報</a></li> </ul> </div> <p class="NR-copyright"><small><span class="small">©NTT DOCOMO</span></small></p> </div> <div id="NR-footer-ci"> <img src="https://u.xgoo.jp/img/docomo.png" width="120" height="30" alt="NTT DOCOMO"> </div> </div></footer> </div> <script src="https://u.xgoo.jp/jquery/v3/3.js"></script> <script src="https://u.xgoo.jp/js/1.1.js"></script>  <script> var ajaxurl = 'https://labs.goo.ne.jp/wp-admin/admin-ajax.php'; </script> <script src="https://labs.goo.ne.jp/wp-content/themes/goolab_3.0.0/js/script.js"></script>  <script src="//log000.goo.ne.jp/js/VLTraceDMD.js"></script> </body> </html>