J-GLOBALについて

ENGLISH

文字サイズ
  • 小
  • 大

ヘルプ

WebAPIの提供

只今、WebAPIの利用申請受付を停止させていただいております。

J-GLOBAL の検索機能・出力データを自身の Webサイトで利用するための、「WebAPI」プログラムの提供を開始します。「WebAPI」は、J-GLOBAL の機能を他のサイトで利用できるようにするプログラムで、そのプログラムを組み込むことにより、手軽に J-GLOBAL の検索機能を使い、結果として得られた J-GLOBAL のデータを、自身のサイトで組み合わせて利用することができます。

  1. 1. J-GLOBAL WebAPI の概要と特徴
  2. 2. WebAPI ご利用の流れ
  3. 3. WebAPI関数について
  4. 4. J-GLOBAL 新WebAPI利用方法
  5. 5. 動作可能なサンプルスクリプト
  6. 6. JSON 形式の構造体について
  7. 7. 検索窓の配布について
  8. 8. より高度な連携について
  9. 9. よくあるご質問

1.J-GLOBAL WebAPIの概要と特徴

この WebAPI は、利用者自身が管理・運営しているWebサイト上で、Javascript をベースとしたスクリプトを組み込んだ Web ページを作成いただくことで、J-GLOBAL がもっているリソースを検索し、取得された検索結果を加工するなどして、検索結果を表示することができるインタフェースです。

J-GLOBAL WebAPI の特徴は、下記の通りです。

  • WebAPI が対象とする基本情報は「文献」、「科学技術用語」、「化学物質」、「資料」の4種類です。
  • J-GLOBAL サイトの検索結果一覧と同等レベルの情報を取得できます。
  • 検索結果は、あらかじめレイアウトが決まっていて簡単に実装できる HTML 形式と、項目ごとにデータを取得し、自由なレイアウトが可能な JSON 形式の二種類で取得できます。

2.WebAPI ご利用の流れ

WebAPI ご利用の流れ

~アカウント登録(無料)~

※WebAPIを利用するためには、MyJ-GLOBALへのアカウント登録が必要です。MyJ-GLOBAL のアカウント登録には費用は掛かりません。

  • J-GLOBAL の各ページヘッダー部分の「MyJ-GLOBALログイン」をクリックし、MyJ-GLOBALログイン画面を表示します。
  • MyJ-GLOBALログイン画面より、「アカウントを作成」をクリックします。
  • アカウント情報を入力します。
  • 登録いただきましたメールアドレスに仮登録メールを送信します。メール内の本登録 URL をクリックすると登録が完了します。
  • J-GLOBAL の各ページヘッダー部分の「MyJ-GLOBALログイン」をクリックし、MyJ-GLOBALログイン画面より、ID/パスワードを入力しログインしてください。

[WebAPI 利用申請]

  • ログインした状態で、「WebAPI」タブをクリックします。
  • WebAPI 申請画面より、WebAPI を組込むサイト情報(URI)を入力します。

※サイト情報はイントラネットの登録はできません。実際に外部ネットワークからアクセス可能な URI を入力してください。

  • WebAPI 利用規約をお読みいただき、同意される場合はチェックボックスにチェックし、申請ボタンをクリックしてください。
  • 申請が受け付けられると WebAPI 申請中の画面になりますので、ご確認ください。

[申請受付処理]

  • 申請内容について、JST 担当者が、申請されたサイト情報(URI)の内容確認を行います。WebAPI 利用規約と照らして適当でないと判断された申請については、JST担当者より、アカウント登録時のメールアドレスに別途問い合わせをさせていただくことがあります。
  • 確認には、最大で1週間程度を要することがあります。

WebAPIキー取得

  • JST担当者により申請受付が行われると、WebAPI キーが発行されます。
  • 合わせて、確認が終了した旨のメールが登録メールアドレスに届きます。
  • WebAPI キーは、WebAPI の画面上にてご確認いただきます。

サイトページ作成(キー組み込み)

  • ログインした状態で、「WebAPI」タブをクリックし、WebAPI 画面上で、WebAPI キーが表示されていることを確認してください。
  • 画面内に表示されている WebAPI キーをサイトページに組み込んでご利用ください。

※WebAPI キーは申請したサイト(URI)以外では使えません。

  • 組込時にはサンプルスクリプトなどを参考にしてください。

以上で WebAPI を使った検索が行える状態になります。

3.WebAPI関数について

4種類の基本情報と2種類の出力形式に対応して、計8種類の WebAPI 関数を用意しました。

関数

1)getHTMLforXXX(function, query, page)
基本情報「XXX」に対し検索し、HTML形式で取得する関数。

2)getJSONforXXX(function, query, page)
基本情報「XXX」に対し検索し、JSON形式で取得する関数。

XXXは下記の4種類です。

  • 「Article」(文献)
  • 「Term」(科学技術用語)
  • 「Chemical」(化学物質)
  • 「Materials」(資料)

引数

  • function:検索結果データを取得・加工・表示するための呼び出し関数名
  • query : 検索キーワード(論理積はスペース、論理和は「OR」を入力)
  • page : 取得するページ(1ページ当たりの件数は20件)

サンプル


//基本情報「論文」に対して「アスベスト」で検索し、1ページ目(1~20件目)を取得するし、HTMLで表示する

var s = new jglobal.search();
s.getHTMLforArticle("jg_callback", 'アスベスト', 1);

function jg_callback(html){
    document.getElementById("result").innerHTML=html;
}

4.J-GLOBAL 新WebAPI利用方法

v1.0.0

・記載の仕様・使用例は暫定版であり、今後変わる可能性があります。
・年末までは暫定版とし、仕様確定は年明けを予定しています。

文献情報検索

GET
/articles

文献情報を検索します。

パラメータ
q 検索クエリ。sessidの指定が無い場合は必須。
sessid

検索セッションID。

初回リクエストのレスポンスヘッダ"X-JGAPI-SEARCH-SESSID"で返却される値を指定する。

次のページを取得する場合など検索結果を再利用する場合に利用可能。

sessidを指定する場合はqの指定は不要。

st ソート方式
stf ソート項目
p ページ(0開始)
l 取得件数
lang 言語. ja => 日本語, en => 英語

例)/articles?q=燃料電池&p=0&l=3&st=down&stf=UPDT&lang=ja

レスポンス

Headers
X-JGAPI-SEARCH-SESSID 検索セッションID
X-JGAPI-SEARCH-COUNT 検索ヒット件数
X-JGAPI-SEARCH-PAGE ページ番号
X-JGAPI-SEARCH-LENGTH 取得件数
X-JGAPI-SEARCH-LASTPAGE 取得可能最終ページ
X-JGAPI-SEARCH-REUSE 検索結果再利用URL
X-JGAPI-SEARCH-REUSE-PAGING ページング用URL。2ページ目以降取得の際にこのURLに「&p=ページ番号」を付けて取得可能。

返却されるJSONのスキーマは以下になります

application/json

{
    "description": "文献情報一覧", 
    "type": "array", 
    "items": {
        "description": "文献基本情報", 
        "properties": {
            "jgid": {
                "description": "J-GLOBAL ID", 
                "type": "string"
            }, 
            "url": {
                "description": "J-GLOBAL詳細画面のURL", 
                "type": "string"
            }, 
            "title": {
                "description": "タイトル", 
                "type": "string"
            }, 
            "year": {
                "description": "発行年", 
                "type": "string"
            }, 
            "volume": {
                "description": "巻", 
                "type": "string"
            }, 
            "number": {
                "description": "号", 
                "type": "string"
            }, 
            "special_number": {
                "description": "特殊号", 
                "type": "string"
            }, 
            "trans_titles": {
                "description": "翻訳タイトル", 
                "type": "array", 
                "items": {
                    "description": "タイトル情報", 
                    "type": "object", 
                    "properties": {
                        "type": {
                            "description": "タイトル種別", 
                            "type": "string"
                        }, 
                        "lang": {
                            "description": "言語", 
                            "type": "string"
                        }, 
                        "copyright": {
                            "description": "コピーライト", 
                            "type": "string"
                        }, 
                        "title": {
                            "description": "タイトル", 
                            "type": "string"
                        }
                    }
                }
            }, 
            "journal": {
                "description": "資料情報", 
                "properties": {
                    "name": {
                        "description": "資料名", 
                        "type": "string"
                    }, 
                    "issns": {
                        "description": "ISSNのリスト", 
                        "type": "array", 
                        "items": {
                            "description": "ISSN情報", 
                            "type": "object", 
                            "properties": {
                                "type": {
                                    "description": "ISSN区分", 
                                    "type": "string"
                                }, 
                                "issn": {
                                    "description": "ISSN", 
                                    "type": "string"
                                }
                            }
                        }
                    }, 
                    "isbn": {
                        "description": "ISBN", 
                        "type": "string"
                    }, 
                    "coden": {
                        "description": "CODEN", 
                        "type": "string"
                    }, 
                    "link": {
                        "description": "リンク情報", 
                        "type": "object", 
                        "properties": {
                            "jst_material_id": {
                                "description": "JST資料番号", 
                                "type": "string"
                            }, 
                            "jgid": {
                                "description": "J-GLOBAL ID", 
                                "type": "string"
                            }
                        }
                    }
                }
            }, 
            "authors": {
                "description": "著者一覧", 
                "type": "array", 
                "items": {
                    "description": "著者情報", 
                    "properties": {
                        "name": {
                            "description": "著者名", 
                            "type": "string"
                        }, 
                        "affiliations": {
                            "description": "所属情報", 
                            "type": "array", 
                            "items": {
                                "description": "機関情報", 
                                "properties": {
                                    "name": {
                                        "description": "機関名", 
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
 

出力例

URL
/articles?q=燃料電池&p=0&l=3&st=down&stf=UPDT&lang=ja

Headers

X-JGAPI-SEARCH-COUNT: 
98055
X-JGAPI-SEARCH-LASTPAGE:: 
3333
X-JGAPI-SEARCH-LENGTH: 
3
X-JGAPI-SEARCH-PAGE: 
0
X-JGAPI-SEARCH-REUSE: 
https://api.jglobal.jst.go.jp/jgapi/v1/articles?sessid=203372690ae3af563b3f82a48e6fe60f5cc941
X-JGAPI-SEARCH-REUSE-PAGING: 
https://api.jglobal.jst.go.jp/jgapi/v1/articles?sessid=203372690ae3af563b3f82a48e6fe60f5cc941&lang=ja&l=3
X-JGAPI-SEARCH-SESSID: 
203372690ae3af563b3f82a48e6fe60f5cc941

application/json

   
   [
    {
        "jgid": "201802292805317016",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=201802292805317016",
        "title": "マグネシウム空気燃料電池電気凝固法を用いた合成廃水からのストルーバイトとしての電力生産とりんの回収【Powered by NICT】",
        "trans_titles": [
            {
                "lang": "en",
                "title": "Electricity production and phosphorous recovery as struvite from synthetic wastewater using magnesium-air fuel cell electrocoagulation"
            }
        ],
        "year": "2018",
        "volume": "132",
        "journal": {
            "name": "Water Research",
            "issns": [
                {
                    "issn": "0043-1354"
                }
            ],
            "link": {
                "jst_material_id": "B0760A",
                "jgid": "200909093847843727"
            }
        },
        "authors": [
            {
                "name": "Kim Jung Hwan",
                "affiliations": [
                    {
                        "name": "Department of Civil and Environmental Engineering, Hanyang University, 17 Haengdang-dong, Seongdong-gu, Seoul 133-791, Republic of Korea"
                    }
                ]
            },
            {
                "name": "An Byung min",
                "affiliations": [
                    {
                        "name": "Department of Civil and Environmental Engineering, Hanyang University, 17 Haengdang-dong, Seongdong-gu, Seoul 133-791, Republic of Korea"
                    }
                ]
            },
            {
                "name": "Lim Dae Hwan",
                "affiliations": [
                    {
                        "name": "Department of Civil and Environmental Engineering, Hanyang University, 17 Haengdang-dong, Seongdong-gu, Seoul 133-791, Republic of Korea"
                    }
                ]
            },
            {
                "name": "Park Joo Yang",
                "affiliations": [
                    {
                        "name": "Department of Civil and Environmental Engineering, Hanyang University, 17 Haengdang-dong, Seongdong-gu, Seoul 133-791, Republic of Korea"
                    }
                ]
            }
        ]
    },
    {
        "jgid": "201802291871772991",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=201802291871772991",
        "title": "プロトン伝導La_0 99Ca_0 0.01NbO_4電解質を用いた固体酸化物燃料電池【Powered by NICT】",
        "trans_titles": [
            {
                "lang": "en",
                "title": "Solid oxide fuel cells with proton-conducting La0.99Ca0.01NbO4 electrolyte"
            }
        ],
        "year": "2018",
        "volume": "260",
        "journal": {
            "name": "Electrochimica Acta",
            "issns": [
                {
                    "issn": "0013-4686"
                }
            ],
            "link": {
                "jst_material_id": "B0535B",
                "jgid": "200909016087236723"
            }
        },
        "authors": [
            {
                "name": "Bi Lei",
                "affiliations": [
                    {
                        "name": "Institute of Materials for Energy and Environment, Qingdao University, Ningxia Road No.308, Qingdao, 266071, China"
                    }
                ]
            },
            {
                "name": "Bi Lei",
                "affiliations": [
                    {
                        "name": "College of Materials Science and Engineering, Qingdao University, Ningxia Road No.308, Qingdao, 266071, China"
                    }
                ]
            },
            {
                "name": "Fabbri Emiliana",
                "affiliations": [
                    {
                        "name": "Electrochemistry Laboratory, Paul Scherrer Institut, 5232, Villigen, Switzerland"
                    }
                ]
            },
            {
                "name": "Traversa Enrico",
                "affiliations": [
                    {
                        "name": "School of Energy Science and Engineering, University of Electronic Science and Technology of China, 2006, Xiyuan Road, Chengdu, Sichuan, China"
                    }
                ]
            }
        ]
    },
    {
        "jgid": "201802291664599786",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=201802291664599786",
        "title": "PIDコントローラを用いた燃料電池電源DC電動機の実験結果とシミュレーションとの比較【Powered by NICT】",
        "trans_titles": [
            {
                "lang": "en",
                "title": "Comparison between experimental results and simulation of a fuel cell powered DC motor using PID controller"
            }
        ],
        "year": "2017",
        "volume": "2017",
        "number": "EPEC",
        "journal": {
            "name": "IEEE Conference Proceedings",
            "link": {
                "jst_material_id": "W2441A",
                "jgid": "201709006569611472"
            }
        },
        "authors": [
            {
                "name": "Albarghot Mohamed",
                "affiliations": [
                    {
                        "name": "Department of Mechanical Engineering, Memorial University of Newfoundland, St. John’s, NL, A1B3X5, Canada"
                    }
                ]
            },
            {
                "name": "Alkarrami Faisal",
                "affiliations": [
                    {
                        "name": "Department of Electrical Engineering, Memorial University of Newfoundland, St. John’s, NL, A1B3X5, Canada"
                    }
                ]
            },
            {
                "name": "O’Young Siu",
                "affiliations": [
                    {
                        "name": "Department of Electrical Engineering, Memorial University of Newfoundland, St. John’s, NL, A1B3X5, Canada"
                    }
                ]
            },
            {
                "name": "Rolland Luc",
                "affiliations": [
                    {
                        "name": "CEO, LART - Lenoir Automation Robots Technologies"
                    }
                ]
            }
        ]
    }
   ]
   
  

文献情報取得

GET
/articles/{jgid},{jgid},...

J-GLOBAL IDを指定して文献情報を取得します。

パラメータ
jgid *必須 取得する基本情報のJ-GLOBAL ID(カンマ区切りで最大100まで指定可能)
lang 言語. ja => 日本語, en => 英語

レスポンス

返却されるJSONのスキーマは以下になります

application/json

{
    "description": "文献情報一覧", 
    "type": "array", 
    "items": {
        "description": "文献基本情報", 
        "properties": {
            "jgid": {
                "description": "J-GLOBAL ID", 
                "type": "string"
            }, 
            "url": {
                "description": "J-GLOBAL詳細画面のURL", 
                "type": "string"
            }, 
            "title": {
                "description": "タイトル", 
                "type": "string"
            }, 
            "year": {
                "description": "発行年", 
                "type": "string"
            }, 
            "volume": {
                "description": "巻", 
                "type": "string"
            }, 
            "number": {
                "description": "号", 
                "type": "string"
            }, 
            "special_number": {
                "description": "特殊号", 
                "type": "string"
            }, 
            "trans_titles": {
                "description": "翻訳タイトル", 
                "type": "array", 
                "items": {
                    "description": "タイトル情報", 
                    "type": "object", 
                    "properties": {
                        "type": {
                            "description": "タイトル種別", 
                            "type": "string"
                        }, 
                        "lang": {
                            "description": "言語", 
                            "type": "string"
                        }, 
                        "copyright": {
                            "description": "コピーライト", 
                            "type": "string"
                        }, 
                        "title": {
                            "description": "タイトル", 
                            "type": "string"
                        }
                    }
                }
            }, 
            "journal": {
                "description": "資料情報", 
                "properties": {
                    "name": {
                        "description": "資料名", 
                        "type": "string"
                    }, 
                    "issns": {
                        "description": "ISSNのリスト", 
                        "type": "array", 
                        "items": {
                            "description": "ISSN情報", 
                            "type": "object", 
                            "properties": {
                                "type": {
                                    "description": "ISSN区分", 
                                    "type": "string"
                                }, 
                                "issn": {
                                    "description": "ISSN", 
                                    "type": "string"
                                }
                            }
                        }
                    }, 
                    "isbn": {
                        "description": "ISBN", 
                        "type": "string"
                    }, 
                    "coden": {
                        "description": "CODEN", 
                        "type": "string"
                    }, 
                    "link": {
                        "description": "リンク情報", 
                        "type": "object", 
                        "properties": {
                            "jst_material_id": {
                                "description": "JST資料番号", 
                                "type": "string"
                            }, 
                            "jgid": {
                                "description": "J-GLOBAL ID", 
                                "type": "string"
                            }
                        }
                    }
                }
            }, 
            "authors": {
                "description": "著者一覧", 
                "type": "array", 
                "items": {
                    "description": "著者情報", 
                    "properties": {
                        "name": {
                            "description": "著者名", 
                            "type": "string"
                        }, 
                        "affiliations": {
                            "description": "所属情報", 
                            "type": "array", 
                            "items": {
                                "description": "機関情報", 
                                "properties": {
                                    "name": {
                                        "description": "機関名", 
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
 

出力例

URL
/articles/201802292805317016,201802291871772991,201802291664599786?lang=ja

application/json

   
   [
    {
        "jgid": "201802292805317016",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=201802292805317016",
        "title": "マグネシウム空気燃料電池電気凝固法を用いた合成廃水からのストルーバイトとしての電力生産とりんの回収【Powered by NICT】",
        "trans_titles": [
            {
                "lang": "en",
                "title": "Electricity production and phosphorous recovery as struvite from synthetic wastewater using magnesium-air fuel cell electrocoagulation"
            }
        ],
        "year": "2018",
        "volume": "132",
        "journal": {
            "name": "Water Research",
            "issns": [
                {
                    "issn": "0043-1354"
                }
            ],
            "link": {
                "jst_material_id": "B0760A",
                "jgid": "200909093847843727"
            }
        },
        "authors": [
            {
                "name": "Kim Jung Hwan",
                "affiliations": [
                    {
                        "name": "Department of Civil and Environmental Engineering, Hanyang University, 17 Haengdang-dong, Seongdong-gu, Seoul 133-791, Republic of Korea"
                    }
                ]
            },
            {
                "name": "An Byung min",
                "affiliations": [
                    {
                        "name": "Department of Civil and Environmental Engineering, Hanyang University, 17 Haengdang-dong, Seongdong-gu, Seoul 133-791, Republic of Korea"
                    }
                ]
            },
            {
                "name": "Lim Dae Hwan",
                "affiliations": [
                    {
                        "name": "Department of Civil and Environmental Engineering, Hanyang University, 17 Haengdang-dong, Seongdong-gu, Seoul 133-791, Republic of Korea"
                    }
                ]
            },
            {
                "name": "Park Joo Yang",
                "affiliations": [
                    {
                        "name": "Department of Civil and Environmental Engineering, Hanyang University, 17 Haengdang-dong, Seongdong-gu, Seoul 133-791, Republic of Korea"
                    }
                ]
            }
        ]
    },
    {
        "jgid": "201802291871772991",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=201802291871772991",
        "title": "プロトン伝導La_0 99Ca_0 0.01NbO_4電解質を用いた固体酸化物燃料電池【Powered by NICT】",
        "trans_titles": [
            {
                "lang": "en",
                "title": "Solid oxide fuel cells with proton-conducting La0.99Ca0.01NbO4 electrolyte"
            }
        ],
        "year": "2018",
        "volume": "260",
        "journal": {
            "name": "Electrochimica Acta",
            "issns": [
                {
                    "issn": "0013-4686"
                }
            ],
            "link": {
                "jst_material_id": "B0535B",
                "jgid": "200909016087236723"
            }
        },
        "authors": [
            {
                "name": "Bi Lei",
                "affiliations": [
                    {
                        "name": "Institute of Materials for Energy and Environment, Qingdao University, Ningxia Road No.308, Qingdao, 266071, China"
                    }
                ]
            },
            {
                "name": "Bi Lei",
                "affiliations": [
                    {
                        "name": "College of Materials Science and Engineering, Qingdao University, Ningxia Road No.308, Qingdao, 266071, China"
                    }
                ]
            },
            {
                "name": "Fabbri Emiliana",
                "affiliations": [
                    {
                        "name": "Electrochemistry Laboratory, Paul Scherrer Institut, 5232, Villigen, Switzerland"
                    }
                ]
            },
            {
                "name": "Traversa Enrico",
                "affiliations": [
                    {
                        "name": "School of Energy Science and Engineering, University of Electronic Science and Technology of China, 2006, Xiyuan Road, Chengdu, Sichuan, China"
                    }
                ]
            }
        ]
    },
    {
        "jgid": "201802291664599786",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=201802291664599786",
        "title": "PIDコントローラを用いた燃料電池電源DC電動機の実験結果とシミュレーションとの比較【Powered by NICT】",
        "trans_titles": [
            {
                "lang": "en",
                "title": "Comparison between experimental results and simulation of a fuel cell powered DC motor using PID controller"
            }
        ],
        "year": "2017",
        "volume": "2017",
        "number": "EPEC",
        "journal": {
            "name": "IEEE Conference Proceedings",
            "link": {
                "jst_material_id": "W2441A",
                "jgid": "201709006569611472"
            }
        },
        "authors": [
            {
                "name": "Albarghot Mohamed",
                "affiliations": [
                    {
                        "name": "Department of Mechanical Engineering, Memorial University of Newfoundland, St. John’s, NL, A1B3X5, Canada"
                    }
                ]
            },
            {
                "name": "Alkarrami Faisal",
                "affiliations": [
                    {
                        "name": "Department of Electrical Engineering, Memorial University of Newfoundland, St. John’s, NL, A1B3X5, Canada"
                    }
                ]
            },
            {
                "name": "O’Young Siu",
                "affiliations": [
                    {
                        "name": "Department of Electrical Engineering, Memorial University of Newfoundland, St. John’s, NL, A1B3X5, Canada"
                    }
                ]
            },
            {
                "name": "Rolland Luc",
                "affiliations": [
                    {
                        "name": "CEO, LART - Lenoir Automation Robots Technologies"
                    }
                ]
            }
        ]
    }
   ]
   
   

科学技術用語検索

GET
/terms

科学技術用語を検索します。

パラメータ
q 検索クエリ。sessidの指定が無い場合は必須。
sessid

検索セッションID。

初回リクエストのレスポンスヘッダ"X-JGAPI-SEARCH-SESSID"で返却される値を指定する。

次のページを取得する場合など検索結果を再利用する場合に利用可能。

sessidを指定する場合はqの指定は不要。

st ソート方式
stf ソート項目
p ページ(0開始)
l 取得件数
lang 言語. ja => 日本語, en => 英語

例)/terms?q=燃料電池&p=0&l=3&st=down&stf=UPDT&lang=ja

レスポンス

Headers
X-JGAPI-SEARCH-SESSID 検索セッションID
X-JGAPI-SEARCH-COUNT 検索ヒット件数
X-JGAPI-SEARCH-PAGE ページ番号
X-JGAPI-SEARCH-LENGTH 取得件数
X-JGAPI-SEARCH-LASTPAGE 取得可能最終ページ
X-JGAPI-SEARCH-REUSE 検索結果再利用URL
X-JGAPI-SEARCH-REUSE-PAGING ページング用URL。2ページ目以降取得の際にこのURLに「&p=ページ番号」を付けて取得可能。

返却されるJSONのスキーマは以下になります

application/json

{
    "description": "科学技術用語の配列", 
    "type": "array", 
    "items": {
        "description": "科学技術用語基本情報", 
        "properties": {
            "jgid": {
                "description": "J-GLOBAL ID", 
                "type": "string"
            }, 
            "url": {
                "description": "J-GLOBAL詳細画面のURL", 
                "type": "string"
            }, 
            "title": {
                "description": "タイトル", 
                "type": "string"
            }, 
            "aliases": {
                "description": "名称異表記", 
                "type": "array", 
                "items": {
                    "type": "string"
                }
            }, 
            "synonym": {
                "description": "同義語情報", 
                "type": "object", 
                "properties": {
                    "size": {
                        "description": "件数", 
                        "type": "integer"
                    }, 
                    "items": {
                        "type": "array", 
                        "items": {
                            "description": "用語情報", 
                            "properties": {
                                "name": {
                                    "description": "用語名", 
                                    "type": "string"
                                }, 
                                "name_ja": {
                                    "description": "用語名(日本語)", 
                                    "type": "string"
                                }, 
                                "name_en": {
                                    "description": "用語名(英語)", 
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            }, 
            "synonym_chemical": {
                "description": "同義語(化合物)", 
                "type": "object", 
                "properties": {
                    "size": {
                        "description": "件数", 
                        "type": "integer"
                    }, 
                    "items": {
                        "type": "array", 
                        "items": {
                            "description": "化学物質情報", 
                            "properties": {
                                "name": {
                                    "description": "名称", 
                                    "type": "string"
                                }, 
                                "name_ja": {
                                    "description": "日本語名称", 
                                    "type": "string"
                                }, 
                                "name_en": {
                                    "description": "英語名称", 
                                    "type": "string"
                                }, 
                                "link": {
                                    "description": "リンク情報", 
                                    "type": "object", 
                                    "properties": {
                                        "nikkaji_id": {
                                            "description": "日化辞ID", 
                                            "type": "string"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }, 
            "related_term": {
                "description": "関連語情報", 
                "type": "object", 
                "properties": {
                    "size": {
                        "description": "件数", 
                        "type": "integer"
                    }, 
                    "items": {
                        "type": "array", 
                        "items": {
                            "description": "用語情報", 
                            "properties": {
                                "name": {
                                    "description": "用語名", 
                                    "type": "string"
                                }, 
                                "name_ja": {
                                    "description": "用語名(日本語)", 
                                    "type": "string"
                                }, 
                                "name_en": {
                                    "description": "用語名(英語)", 
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            }, 
            "related_chemical": {
                "description": "関連化合物", 
                "type": "object", 
                "properties": {
                    "size": {
                        "description": "件数", 
                        "type": "integer"
                    }, 
                    "items": {
                        "type": "array", 
                        "items": {
                            "description": "化学物質情報", 
                            "properties": {
                                "name": {
                                    "description": "名称", 
                                    "type": "string"
                                }, 
                                "name_ja": {
                                    "description": "日本語名称", 
                                    "type": "string"
                                }, 
                                "name_en": {
                                    "description": "英語名称", 
                                    "type": "string"
                                }, 
                                "link": {
                                    "description": "リンク情報", 
                                    "type": "object", 
                                    "properties": {
                                        "nikkaji_id": {
                                            "description": "日化辞ID", 
                                            "type": "string"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }, 
            "broader": {
                "description": "上位語", 
                "type": "object", 
                "properties": {
                    "size": {
                        "description": "件数", 
                        "type": "integer"
                    }, 
                    "items": {
                        "type": "array", 
                        "items": {
                            "description": "用語情報", 
                            "properties": {
                                "name": {
                                    "description": "用語名", 
                                    "type": "string"
                                }, 
                                "name_ja": {
                                    "description": "用語名(日本語)", 
                                    "type": "string"
                                }, 
                                "name_en": {
                                    "description": "用語名(英語)", 
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            }, 
            "narrower": {
                "description": "下位語", 
                "type": "object", 
                "properties": {
                    "size": {
                        "description": "件数", 
                        "type": "integer"
                    }, 
                    "items": {
                        "type": "array", 
                        "items": {
                            "description": "用語情報", 
                            "properties": {
                                "name": {
                                    "description": "用語名", 
                                    "type": "string"
                                }, 
                                "name_ja": {
                                    "description": "用語名(日本語)", 
                                    "type": "string"
                                }, 
                                "name_en": {
                                    "description": "用語名(英語)", 
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
 

出力例

URL
/terms?q=燃料電池&p=0&l=3&st=down&stf=UPDT&lang=ja

Headers

X-JGAPI-SEARCH-COUNT: 
195
X-JGAPI-SEARCH-LASTPAGE:
64
X-JGAPI-SEARCH-LENGTH:
3
X-JGAPI-SEARCH-PAGE:
0
X-JGAPI-SEARCH-REUSE:
https://api.jglobal.jst.go.jp/jgapi/v1/terms?sessid=f38c93969560bfe75569a7bed17d2b7063ae69
X-JGAPI-SEARCH-REUSE-PAGING:
https://api.jglobal.jst.go.jp/jgapi/v1/terms?sessid=f38c93969560bfe75569a7bed17d2b7063ae69&lang=ja&l=3
X-JGAPI-SEARCH-SESSID:
f38c93969560bfe75569a7bed17d2b7063ae69

application/json

   
   [
    {
        "jgid": "201606021230510759",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=201606021230510759",
        "title": "低温固体酸化物燃料電池",
        "aliases": [
            "低温固体酸化物燃料電池"
        ],
        "broader": {
            "size": 1,
            "items": [
                {
                    "name": "固体酸化物燃料電池",
                    "name_ja": "固体酸化物燃料電池"
                }
            ]
        }
    },
    {
        "jgid": "201606018499602594",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=201606018499602594",
        "title": "固体酸化物",
        "aliases": [
            "固体酸化物"
        ],
        "related_term": {
            "size": 2,
            "items": [
                {
                    "name": "固体",
                    "name_ja": "固体"
                },
                {
                    "name": "燃料電池",
                    "name_ja": "燃料電池"
                }
            ]
        },
        "broader": {
            "size": 1,
            "items": [
                {
                    "name": "酸化物",
                    "name_ja": "酸化物"
                }
            ]
        }
    },
    {
        "jgid": "201606015325874723",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=201606015325874723",
        "title": "全固体電池",
        "aliases": [
            "全固体電池"
        ],
        "related_term": {
            "size": 2,
            "items": [
                {
                    "name": "リチウム二次電池",
                    "name_ja": "リチウム二次電池"
                },
                {
                    "name": "固体電解質燃料電池",
                    "name_ja": "固体電解質燃料電池"
                }
            ]
        },
        "broader": {
            "size": 1,
            "items": [
                {
                    "name": "電池",
                    "name_ja": "電池"
                }
            ]
        }
    }
   ]
   
  

科学技術用語情報取得

GET
/terms/{jgid},{jgid},...

J-GLOBAL IDを指定して科学技術用語情報を取得します。

パラメータ
jgid *必須 取得する基本情報のJ-GLOBAL ID(カンマ区切りで最大100まで指定可能)
lang 言語. ja => 日本語, en => 英語

レスポンス

返却されるJSONのスキーマは以下になります

application/json

{
    "description": "科学技術用語基本情報", 
    "properties": {
        "jgid": {
            "description": "J-GLOBAL ID", 
            "type": "string"
        }, 
        "url": {
            "description": "J-GLOBAL詳細画面のURL", 
            "type": "string"
        }, 
        "title": {
            "description": "タイトル", 
            "type": "string"
        }, 
        "aliases": {
            "description": "名称異表記", 
            "type": "array", 
            "items": {
                "type": "string"
            }
        }, 
        "synonym": {
            "description": "同義語情報", 
            "type": "object", 
            "properties": {
                "size": {
                    "description": "件数", 
                    "type": "integer"
                }, 
                "items": {
                    "type": "array", 
                    "items": {
                        "description": "用語情報", 
                        "properties": {
                            "name": {
                                "description": "用語名", 
                                "type": "string"
                            }, 
                            "name_ja": {
                                "description": "用語名(日本語)", 
                                "type": "string"
                            }, 
                            "name_en": {
                                "description": "用語名(英語)", 
                                "type": "string"
                            }
                        }
                    }
                }
            }
        }, 
        "synonym_chemical": {
            "description": "同義語(化合物)", 
            "type": "object", 
            "properties": {
                "size": {
                    "description": "件数", 
                    "type": "integer"
                }, 
                "items": {
                    "type": "array", 
                    "items": {
                        "description": "化学物質情報", 
                        "properties": {
                            "name": {
                                "description": "名称", 
                                "type": "string"
                            }, 
                            "name_ja": {
                                "description": "日本語名称", 
                                "type": "string"
                            }, 
                            "name_en": {
                                "description": "英語名称", 
                                "type": "string"
                            }, 
                            "link": {
                                "description": "リンク情報", 
                                "type": "object", 
                                "properties": {
                                    "nikkaji_id": {
                                        "description": "日化辞ID", 
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }, 
        "related_term": {
            "description": "関連語情報", 
            "type": "object", 
            "properties": {
                "size": {
                    "description": "件数", 
                    "type": "integer"
                }, 
                "items": {
                    "type": "array", 
                    "items": {
                        "description": "用語情報", 
                        "properties": {
                            "name": {
                                "description": "用語名", 
                                "type": "string"
                            }, 
                            "name_ja": {
                                "description": "用語名(日本語)", 
                                "type": "string"
                            }, 
                            "name_en": {
                                "description": "用語名(英語)", 
                                "type": "string"
                            }
                        }
                    }
                }
            }
        }, 
        "related_chemical": {
            "description": "関連化合物", 
            "type": "object", 
            "properties": {
                "size": {
                    "description": "件数", 
                    "type": "integer"
                }, 
                "items": {
                    "type": "array", 
                    "items": {
                        "description": "化学物質情報", 
                        "properties": {
                            "name": {
                                "description": "名称", 
                                "type": "string"
                            }, 
                            "name_ja": {
                                "description": "日本語名称", 
                                "type": "string"
                            }, 
                            "name_en": {
                                "description": "英語名称", 
                                "type": "string"
                            }, 
                            "link": {
                                "description": "リンク情報", 
                                "type": "object", 
                                "properties": {
                                    "nikkaji_id": {
                                        "description": "日化辞ID", 
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }, 
        "broader": {
            "description": "上位語", 
            "type": "object", 
            "properties": {
                "size": {
                    "description": "件数", 
                    "type": "integer"
                }, 
                "items": {
                    "type": "array", 
                    "items": {
                        "description": "用語情報", 
                        "properties": {
                            "name": {
                                "description": "用語名", 
                                "type": "string"
                            }, 
                            "name_ja": {
                                "description": "用語名(日本語)", 
                                "type": "string"
                            }, 
                            "name_en": {
                                "description": "用語名(英語)", 
                                "type": "string"
                            }
                        }
                    }
                }
            }
        }, 
        "narrower": {
            "description": "下位語", 
            "type": "object", 
            "properties": {
                "size": {
                    "description": "件数", 
                    "type": "integer"
                }, 
                "items": {
                    "type": "array", 
                    "items": {
                        "description": "用語情報", 
                        "properties": {
                            "name": {
                                "description": "用語名", 
                                "type": "string"
                            }, 
                            "name_ja": {
                                "description": "用語名(日本語)", 
                                "type": "string"
                            }, 
                            "name_en": {
                                "description": "用語名(英語)", 
                                "type": "string"
                            }
                        }
                    }
                }
            }
        }
    }
}
 

出力例

URL
/terms/200906088900523581,200906075659403010,200906079941701606?lang=ja

application/json


   [
    {
        "jgid": "201606021230510759",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=201606021230510759",
        "title": "低温固体酸化物燃料電池",
        "aliases": [
            "低温固体酸化物燃料電池"
        ],
        "broader": {
            "size": 1,
            "items": [
                {
                    "name": "固体酸化物燃料電池",
                    "name_ja": "固体酸化物燃料電池"
                }
            ]
        }
    },
    {
        "jgid": "201606018499602594",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=201606018499602594",
        "title": "固体酸化物",
        "aliases": [
            "固体酸化物"
        ],
        "related_term": {
            "size": 2,
            "items": [
                {
                    "name": "固体",
                    "name_ja": "固体"
                },
                {
                    "name": "燃料電池",
                    "name_ja": "燃料電池"
                }
            ]
        },
        "broader": {
            "size": 1,
            "items": [
                {
                    "name": "酸化物",
                    "name_ja": "酸化物"
                }
            ]
        }
    },
    {
        "jgid": "201606015325874723",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=201606015325874723",
        "title": "全固体電池",
        "aliases": [
            "全固体電池"
        ],
        "related_term": {
            "size": 2,
            "items": [
                {
                    "name": "リチウム二次電池",
                    "name_ja": "リチウム二次電池"
                },
                {
                    "name": "固体電解質燃料電池",
                    "name_ja": "固体電解質燃料電池"
                }
            ]
        },
        "broader": {
            "size": 1,
            "items": [
                {
                    "name": "電池",
                    "name_ja": "電池"
                }
            ]
        }
    }
   ]
   

化学物質検索

GET
/chemicals

化学物質を検索します。

パラメータ
q 検索クエリ。sessidの指定が無い場合は必須。
sessid

検索セッションID。

初回リクエストのレスポンスヘッダ"X-JGAPI-SEARCH-SESSID"で返却される値を指定する。

次のページを取得する場合など検索結果を再利用する場合に利用可能。

sessidを指定する場合はqの指定は不要。

st ソート方式
stf ソート項目
p ページ(0開始)
l 取得件数
lang 言語. ja => 日本語, en => 英語

例)/chemicals?q=スクロース&p=0&l=3&st=score&lang=en

レスポンス

Headers
X-JGAPI-SEARCH-SESSID 検索セッションID
X-JGAPI-SEARCH-COUNT 検索ヒット件数
X-JGAPI-SEARCH-PAGE ページ番号
X-JGAPI-SEARCH-LENGTH 取得件数
X-JGAPI-SEARCH-LASTPAGE 取得可能最終ページ
X-JGAPI-SEARCH-REUSE 検索結果再利用URL
X-JGAPI-SEARCH-REUSE-PAGING ページング用URL。2ページ目以降取得の際にこのURLに「&p=ページ番号」を付けて取得可能。

返却されるJSONのスキーマは以下になります

application/json

{
    "description": "化学物質の配列", 
    "type": "array", 
    "items": {
        "description": "化学物質基本情報", 
        "properties": {
            "jgid": {
                "description": "J-GLOBAL ID", 
                "type": "string"
            }, 
            "url": {
                "description": "J-GLOBAL詳細画面のURL", 
                "type": "string"
            }, 
            "title": {
                "description": "タイトル", 
                "type": "string"
            }, 
            "nikkaji_id": {
                "description": "日化辞ID", 
                "type": "string"
            }, 
            "name_ja": {
                "description": "日本語名称", 
                "type": "string"
            }, 
            "name_en": {
                "description": "英語名称", 
                "type": "string"
            }, 
            "molecular_formula": {
                "description": "分子式(書式付)", 
                "type": "string"
            }, 
            "molecular_formula_kana": {
                "description": "分子式(簡易書式)", 
                "type": "string"
            }, 
            "systematic_names": { 
                "description": "体系名", 
                  "type": "array", 
                  "items": { 
                    "type": "string"
                } 
            },
            "other_names": {
                "description": "慣用名", 
                "type": "array", 
                "items": {
                    "type": "string"
                }
            }
        }
    }
}
 

出力例

URL
/chemicals?q=スクロース&p=0&l=3&st=score&lang=en

Headers

X-JGAPI-SEARCH-COUNT: 
69
X-JGAPI-SEARCH-LASTPAGE:
22
X-JGAPI-SEARCH-LENGTH:
3
X-JGAPI-SEARCH-PAGE:
0
X-JGAPI-SEARCH-REUSE:
https://api.jglobal.jst.go.jp/jgapi/v1/chemicals?sessid=203372690ae3af563b3f82a48e6f84842e7b08
X-JGAPI-SEARCH-REUSE-PAGING:
https://api.jglobal.jst.go.jp/jgapi/v1/chemicals?sessid=203372690ae3af563b3f82a48e6f84842e7b08&lang=en&l=3
X-JGAPI-SEARCH-SESSID:
203372690ae3af563b3f82a48e6f84842e7b08

application/json

   
[
    {
        "jgid": "200907059877441070",
        "url": "http:\/\/jglobal.jst.go.jp\/en\/detail?JGLOBAL_ID=200907059877441070",
        "title": "Sucrose octaacetate",
        "nikkaji_id": "J5.550F",
        "name_ja": "スクロースオクタアセタート",
        "name_en": "Sucrose octaacetate",
        "molecular_formula": "C<sub>28<\/sub>H<sub>38<\/sub>O<sub>19<\/sub>",
        "molecular_formula_kana": "C28-H38-O19",
        "systematic_names": [
            "β-D-フルクトフラノシルα-D-グルコピラノシドオクタアセタート",
            "1-O,3-O,4-O,6-O-テトラアセチル-β-D-フルクトフラノシル-α-D-グルコピラノシド2,3,4,6-テトラアセタート",
            "1-O,3-O,4-O,6-O-テトラアセチル-β-D-フルクトフラノシルα-D-グルコピラノシド2,3,4,6-テトラアセタート",
            "1-O,3-O,4-O,6-O-テトラアセチル-β-D-フルクトフラノシル2-O,3-O,4-O,6-O-テトラアセチル-α-D-グルコピラノシド",
            "1-O,3-O,4-O,6-O-テトラアセチル-2-O-(2-O,3-O,4-O,6-O-テトラアセチル-α-D-グルコピラノシル)-β-D-フルクトフラノース",
            "2-O-(α-D-グルコピラノシル)-β-D-フルクトフラノースオクタアセタート"
        ],
        "other_names": [
            "オクタ酢酸スクロース",
            "Sucrose octaacetate",
            "1-O,3-O,4-O,6-O-Tetraacetyl-β-D-fructofuranosyl α-D-glucopyranoside 2,3,4,6-tetraacetate",
            "オクタアセチルスクロース",
            "オクタアセチルシュクロース",
            "Octaacetylsucrose",
            "D-(+)-シュクロースオクタアセタート",
            "D-(+)-Sucrose octaacetate",
            "(+)-D-スクロースオクタアセタート",
            "β-D-Fructofuranosyl α-D-glucopyranoside octaacetate",
            "1-O,3-O,4-O,6-O-Tetraacetyl-β-D-fructofuranosyl-α-D-glucopyranoside 2,3,4,6-tetraacetate",
            "オクタアセチルD-(+)-スクロース",
            "Octaacetyl D-(+)-sucrose",
            "D-(+)-Saccharose octaacetate",
            "D-(+)-スクロースオクタアセタート",
            "D-(+)-サッカロースオクタアセタート",
            "1-O,3-O,4-O,6-O-Tetraacetyl-β-D-fructofuranosyl 2-O,3-O,4-O,6-O-tetraacetyl-α-D-glucopyranoside",
            "スクロースオクタアセタート",
            "1-O,3-O,4-O,6-O-Tetraacetyl-2-O-(2-O,3-O,4-O,6-O-tetraacetyl-α-D-glucopyranosyl)-β-D-fructofuranose",
            "2-O-(α-D-Glucopyranosyl)-β-D-fructofuranose octaacetate",
            "八酢酸しょ糖"
        ]
    },
    {
        "jgid": "200907038832291630",
        "url": "http:\/\/jglobal.jst.go.jp\/en\/detail?JGLOBAL_ID=200907038832291630",
        "title": "Sucrose",
        "nikkaji_id": "J4.581K",
        "name_ja": "しょ糖",
        "name_en": "Sucrose",
        "molecular_formula": "C<sub>12<\/sub>H<sub>22<\/sub>O<sub>11<\/sub>",
        "molecular_formula_kana": "C12-H22-O11",
        "systematic_names": [
            "β-D-フルクトフラノシルα-D-gluco-ヘキソピラノシド",
            "2-O-α-D-グルコピラノシル-β-D-フルクトフラノース",
            "β-D-フルクトフラノシルα-D-グルコピラノシド",
            "1-O-α-D-グルコピラノシル-1-(ヒドロキシメチル)-β-D-アラビノフラノース",
            "2-デオキシ-β-D-フルクトフラノース-2-イルα-D-グルコピラノシド",
            "1-O-β-D-フルクトフラノシル-α-D-グルコピラノース",
            "2-O-(α-D-グルコピラノシル)-β-D-フルクトフラノース",
            "1-O-(β-D-フルクトフラノシル)-α-D-グルコピラノース",
            "2-デオキシ-β-D-フルクトフラノース-5-イルα-D-グルコピラノシド",
            "α-D-グルコピラノシルβ-D-フルクトフラノシド",
            "1-ヒドロキシメチル-β-D-アラビノフラノシルα-D-グルコピラノシド"
        ],
        "other_names": [
            "砂糖",
            "庶糖",
            "ショ糖",
            "しょ糖",
            "ビート糖",
            "スクロース",
            "サッカロース",
            "Sugar",
            "Sucrose",
            "Beet sugar",
            "Cane sugar",
            "Saccharose",
            "β-D-Fructofuranosyl α-D-glucopyranoside",
            "シュクロース",
            "2-O-α-D-Glucopyranosyl-β-D-fructofuranose",
            "(+)-サッカロース",
            "D-(+)-Sucrose",
            "D-(+)-Saccharose",
            "(+)-D-スクロース",
            "1-O-α-D-Glucopyranosyl-1-(hydroxymethyl)-β-D-arabinofuranose",
            "2-Deoxy-β-D-fructofuranose-2-yl α-D-glucopyranoside",
            "1-O-β-D-Fructofuranosyl-α-D-glucopyranose",
            "白糖",
            "White soft sugar",
            "2-O-(α-D-Glucopyranosyl)-β-D-fructofuranose",
            "1-O-(β-D-Fructofuranosyl)-α-D-glucopyranose",
            "D-Saccharose",
            "D-サッカロース",
            "2-Deoxy-β-D-fructofuranose-5-yl α-D-glucopyranoside",
            "α-D-Glucopyranosyl β-D-fructofuranoside",
            "1-Hydroxymethyl-β-D-arabinofuranosyl α-D-glucopyranoside"
        ]
    },
    {
        "jgid": "200907050838989117",
        "url": "http:\/\/jglobal.jst.go.jp\/en\/detail?JGLOBAL_ID=200907050838989117",
        "title": "Lactosucrose",
        "nikkaji_id": "J571.160F",
        "name_ja": "ラクトスクロース",
        "name_en": "Lactosucrose",
        "molecular_formula": "C<sub>18<\/sub>H<sub>32<\/sub>O<sub>16<\/sub>",
        "molecular_formula_kana": "C18-H32-O16",
        "systematic_names": [
            "2-O-(4-O-β-D-ガラクトピラノシル-α-D-グルコピラノシル)-β-D-フルクトフラノース",
            "4-O-β-D-ガラクトピラノシル-α-D-グルコピラノシルβ-D-フルクトフラノシド",
            "β-D-フルクトフラノシル4-O-β-D-ガラクトピラノシル-α-D-グルコピラノシド",
            "4-O-(β-D-ガラクトピラノシル)-α-D-グルコピラノシルβ-D-フルクトフラノシド",
            "2-O-[4-O-(β-D-ガラクトピラノシル)-α-D-グルコピラノシル]-β-D-フルクトフラノース"
        ],
        "other_names": [
            "4<sup>G<\/sup>-β-D-ガラクトシルスクロース",
            "4<sup>G<\/sup>-ガラクトシルスクロース",
            "4<sup>G<\/sup>-Galactosylsucrose",
            "β-D-Fructofuranosyl 4-O-β-D-galactopyranosyl-α-D-glucopyranoside",
            "4-O-β-D-Galactopyranosyl-α-D-glucopyranosyl β-D-fructofuranoside",
            "2-O-(4-O-β-D-Galactopyranosyl-α-D-glucopyranosyl)-β-D-fructofuranose",
            "ラクトシルフルクトシド",
            "Lactosylfructoside",
            "ラクトシュクロース",
            "Lactosucrose",
            "ラクトスクロース",
            "4-O-(β-D-Galactopyranosyl)-α-D-glucopyranosyl β-D-fructofuranoside",
            "2-O-[4-O-(β-D-Galactopyranosyl)-α-D-glucopyranosyl]-β-D-fructofuranose",
            "4<sup>G<\/sup>-β-D-Galactosylsucrose"
        ]
    }
]
   
  

化学物質情報取得

GET
/chemicals/{jgid},{jgid},...

J-GLOBAL IDを指定して化学物質情報を取得します。

パラメータ
jgid *必須 取得する基本情報のJ-GLOBAL ID(カンマ区切りで最大100まで指定可能)
lang 言語. ja => 日本語, en => 英語

レスポンス

返却されるJSONのスキーマは以下になります

application/json

{
    "description": "化学物質の配列", 
    "type": "array", 
    "items": {
        "description": "化学物質基本情報", 
        "properties": {
            "jgid": {
                "description": "J-GLOBAL ID", 
                "type": "string"
            }, 
            "url": {
                "description": "J-GLOBAL詳細画面のURL", 
                "type": "string"
            }, 
            "title": {
                "description": "タイトル", 
                "type": "string"
            }, 
            "nikkaji_id": {
                "description": "日化辞ID", 
                "type": "string"
            }, 
            "name_ja": {
                "description": "日本語名称", 
                "type": "string"
            }, 
            "name_en": {
                "description": "英語名称", 
                "type": "string"
            }, 
            "molecular_formula": {
                "description": "分子式(書式付)", 
                "type": "string"
            }, 
            "molecular_formula_kana": {
                "description": "分子式(簡易書式)", 
                "type": "string"
            },
             "systematic_names": { 
                "description": "体系名", 
                "type": "array", 
                "items": { 
                   "type": "string"
                }
            }, 
            "other_names": {
                "description": "慣用名", 
                "type": "array", 
                "items": {
                    "type": "string"
                }
            }
        }
    }
}
 

出力例

URL
/chemicals/200907059877441070,200907038832291630,200907050838989117?lang=en

application/json


   [
    {
        "jgid": "200907059877441070",
        "url": "http:\/\/jglobal.jst.go.jp\/en\/detail?JGLOBAL_ID=200907059877441070",
        "title": "Sucrose octaacetate",
        "nikkaji_id": "J5.550F",
        "name_ja": "スクロースオクタアセタート",
        "name_en": "Sucrose octaacetate",
        "molecular_formula": "C<sub>28<\/sub>H<sub>38<\/sub>O<sub>19<\/sub>",
        "molecular_formula_kana": "C28-H38-O19",
        "systematic_names": [
            "β-D-フルクトフラノシルα-D-グルコピラノシドオクタアセタート",
            "1-O,3-O,4-O,6-O-テトラアセチル-β-D-フルクトフラノシル-α-D-グルコピラノシド2,3,4,6-テトラアセタート",
            "1-O,3-O,4-O,6-O-テトラアセチル-β-D-フルクトフラノシルα-D-グルコピラノシド2,3,4,6-テトラアセタート",
            "1-O,3-O,4-O,6-O-テトラアセチル-β-D-フルクトフラノシル2-O,3-O,4-O,6-O-テトラアセチル-α-D-グルコピラノシド",
            "1-O,3-O,4-O,6-O-テトラアセチル-2-O-(2-O,3-O,4-O,6-O-テトラアセチル-α-D-グルコピラノシル)-β-D-フルクトフラノース",
            "2-O-(α-D-グルコピラノシル)-β-D-フルクトフラノースオクタアセタート"
        ],
        "other_names": [
            "オクタ酢酸スクロース",
            "Sucrose octaacetate",
            "1-O,3-O,4-O,6-O-Tetraacetyl-β-D-fructofuranosyl α-D-glucopyranoside 2,3,4,6-tetraacetate",
            "オクタアセチルスクロース",
            "オクタアセチルシュクロース",
            "Octaacetylsucrose",
            "D-(+)-シュクロースオクタアセタート",
            "D-(+)-Sucrose octaacetate",
            "(+)-D-スクロースオクタアセタート",
            "β-D-Fructofuranosyl α-D-glucopyranoside octaacetate",
            "1-O,3-O,4-O,6-O-Tetraacetyl-β-D-fructofuranosyl-α-D-glucopyranoside 2,3,4,6-tetraacetate",
            "オクタアセチルD-(+)-スクロース",
            "Octaacetyl D-(+)-sucrose",
            "D-(+)-Saccharose octaacetate",
            "D-(+)-スクロースオクタアセタート",
            "D-(+)-サッカロースオクタアセタート",
            "1-O,3-O,4-O,6-O-Tetraacetyl-β-D-fructofuranosyl 2-O,3-O,4-O,6-O-tetraacetyl-α-D-glucopyranoside",
            "スクロースオクタアセタート",
            "1-O,3-O,4-O,6-O-Tetraacetyl-2-O-(2-O,3-O,4-O,6-O-tetraacetyl-α-D-glucopyranosyl)-β-D-fructofuranose",
            "2-O-(α-D-Glucopyranosyl)-β-D-fructofuranose octaacetate",
            "八酢酸しょ糖"
        ]
    },
    {
        "jgid": "200907038832291630",
        "url": "http:\/\/jglobal.jst.go.jp\/en\/detail?JGLOBAL_ID=200907038832291630",
        "title": "Sucrose",
        "nikkaji_id": "J4.581K",
        "name_ja": "しょ糖",
        "name_en": "Sucrose",
        "molecular_formula": "C<sub>12<\/sub>H<sub>22<\/sub>O<sub>11<\/sub>",
        "molecular_formula_kana": "C12-H22-O11",
        "systematic_names": [
            "β-D-フルクトフラノシルα-D-gluco-ヘキソピラノシド",
            "2-O-α-D-グルコピラノシル-β-D-フルクトフラノース",
            "β-D-フルクトフラノシルα-D-グルコピラノシド",
            "1-O-α-D-グルコピラノシル-1-(ヒドロキシメチル)-β-D-アラビノフラノース",
            "2-デオキシ-β-D-フルクトフラノース-2-イルα-D-グルコピラノシド",
            "1-O-β-D-フルクトフラノシル-α-D-グルコピラノース",
            "2-O-(α-D-グルコピラノシル)-β-D-フルクトフラノース",
            "1-O-(β-D-フルクトフラノシル)-α-D-グルコピラノース",
            "2-デオキシ-β-D-フルクトフラノース-5-イルα-D-グルコピラノシド",
            "α-D-グルコピラノシルβ-D-フルクトフラノシド",
            "1-ヒドロキシメチル-β-D-アラビノフラノシルα-D-グルコピラノシド"
        ],
        "other_names": [
            "砂糖",
            "庶糖",
            "ショ糖",
            "しょ糖",
            "ビート糖",
            "スクロース",
            "サッカロース",
            "Sugar",
            "Sucrose",
            "Beet sugar",
            "Cane sugar",
            "Saccharose",
            "β-D-Fructofuranosyl α-D-glucopyranoside",
            "シュクロース",
            "2-O-α-D-Glucopyranosyl-β-D-fructofuranose",
            "(+)-サッカロース",
            "D-(+)-Sucrose",
            "D-(+)-Saccharose",
            "(+)-D-スクロース",
            "1-O-α-D-Glucopyranosyl-1-(hydroxymethyl)-β-D-arabinofuranose",
            "2-Deoxy-β-D-fructofuranose-2-yl α-D-glucopyranoside",
            "1-O-β-D-Fructofuranosyl-α-D-glucopyranose",
            "白糖",
            "White soft sugar",
            "2-O-(α-D-Glucopyranosyl)-β-D-fructofuranose",
            "1-O-(β-D-Fructofuranosyl)-α-D-glucopyranose",
            "D-Saccharose",
            "D-サッカロース",
            "2-Deoxy-β-D-fructofuranose-5-yl α-D-glucopyranoside",
            "α-D-Glucopyranosyl β-D-fructofuranoside",
            "1-Hydroxymethyl-β-D-arabinofuranosyl α-D-glucopyranoside"
        ]
    },
    {
        "jgid": "200907050838989117",
        "url": "http:\/\/jglobal.jst.go.jp\/en\/detail?JGLOBAL_ID=200907050838989117",
        "title": "Lactosucrose",
        "nikkaji_id": "J571.160F",
        "name_ja": "ラクトスクロース",
        "name_en": "Lactosucrose",
        "molecular_formula": "C<sub>18<\/sub>H<sub>32<\/sub>O<sub>16<\/sub>",
        "molecular_formula_kana": "C18-H32-O16",
        "systematic_names": [
            "2-O-(4-O-β-D-ガラクトピラノシル-α-D-グルコピラノシル)-β-D-フルクトフラノース",
            "4-O-β-D-ガラクトピラノシル-α-D-グルコピラノシルβ-D-フルクトフラノシド",
            "β-D-フルクトフラノシル4-O-β-D-ガラクトピラノシル-α-D-グルコピラノシド",
            "4-O-(β-D-ガラクトピラノシル)-α-D-グルコピラノシルβ-D-フルクトフラノシド",
            "2-O-[4-O-(β-D-ガラクトピラノシル)-α-D-グルコピラノシル]-β-D-フルクトフラノース"
        ],
        "other_names": [
            "4<sup>G<\/sup>-β-D-ガラクトシルスクロース",
            "4<sup>G<\/sup>-ガラクトシルスクロース",
            "4<sup>G<\/sup>-Galactosylsucrose",
            "β-D-Fructofuranosyl 4-O-β-D-galactopyranosyl-α-D-glucopyranoside",
            "4-O-β-D-Galactopyranosyl-α-D-glucopyranosyl β-D-fructofuranoside",
            "2-O-(4-O-β-D-Galactopyranosyl-α-D-glucopyranosyl)-β-D-fructofuranose",
            "ラクトシルフルクトシド",
            "Lactosylfructoside",
            "ラクトシュクロース",
            "Lactosucrose",
            "ラクトスクロース",
            "4-O-(β-D-Galactopyranosyl)-α-D-glucopyranosyl β-D-fructofuranoside",
            "2-O-[4-O-(β-D-Galactopyranosyl)-α-D-glucopyranosyl]-β-D-fructofuranose",
            "4<sup>G<\/sup>-β-D-Galactosylsucrose"
        ]
    }
   ]
   

資料情報検索

GET
/materials

資料情報を検索します。

パラメータ
q 検索クエリ。sessidの指定が無い場合は必須。
sessid

検索セッションID。

初回リクエストのレスポンスヘッダ"X-JGAPI-SEARCH-SESSID"で返却される値を指定する。

次のページを取得する場合など検索結果を再利用する場合に利用可能。

sessidを指定する場合はqの指定は不要。

st ソート方式
stf ソート項目
p ページ(0開始)
l 取得件数
lang 言語. ja => 日本語, en => 英語

例)/materials?q=化学&p=0&l=3&st=score&lang=ja

レスポンス

Headers
X-JGAPI-SEARCH-SESSID 検索セッションID
X-JGAPI-SEARCH-COUNT 検索ヒット件数
X-JGAPI-SEARCH-PAGE ページ番号
X-JGAPI-SEARCH-LENGTH 取得件数
X-JGAPI-SEARCH-LASTPAGE 取得可能最終ページ
X-JGAPI-SEARCH-REUSE 検索結果再利用URL
X-JGAPI-SEARCH-REUSE-PAGING ページング用URL。2ページ目以降取得の際にこのURLに「&p=ページ番号」を付けて取得可能。

返却されるJSONのスキーマは以下になります

application/json

{
    "description": "資料情報の配列", 
    "type": "array", 
    "items": {
        "description": "資料基本情報", 
        "properties": {
            "jgid": {
                "description": "J-GLOBAL ID", 
                "type": "string"
            }, 
            "url": {
                "description": "J-GLOBAL詳細画面のURL", 
                "type": "string"
            }, 
            "title": {
                "description": "タイトル", 
                "type": "string"
            }, 
            "material_number": {
                "description": "資料番号 (フル表記)", 
                "type": "string"
            }, 
            "jdream3_material_number": {
                "description": "資料番号 (6ケタ表記)", 
                "type": "string"
            }, 
            "issn_list": {
                "description": "ISSNのリスト", 
                "type": "array", 
                "items": {
                    "type": "string"
                }
            }, 
            "isbn_list": {
                "description": "ISBNのリスト", 
                "type": "array", 
                "items": {
                    "type": "string"
                }
            }, 
            "coden_list": {
                "description": "CODENのリスト", 
                "type": "array", 
                "items": {
                    "type": "string"
                }
            }, 
            "publishers": {
                "description": "出版団体名", 
                "type": "array", 
                "items": {
                    "type": "string"
                }
            }
        }
    }
}
 

出力例

URL
/materials?q=化学&p=0&l=3&st=score&lang=ja

Headers

X-JGAPI-SEARCH-COUNT: 
7322
X-JGAPI-SEARCH-LASTPAGE:
2457
X-JGAPI-SEARCH-LENGTH:
3
X-JGAPI-SEARCH-PAGE:
0
X-JGAPI-SEARCH-REUSE:
https://api.jglobal.jst.go.jp/jgapi/v1/materials?sessid=f38c93969560bfe75569a7bed17da03cea5d21
X-JGAPI-SEARCH-REUSE-PAGING:
https://api.jglobal.jst.go.jp/jgapi/v1/materials?sessid=f38c93969560bfe75569a7bed17da03cea5d21&lang=ja&l=3
X-JGAPI-SEARCH-SESSID:
f38c93969560bfe75569a7bed17da03cea5d21

application/json

   
[
    {
        "jgid": "200909050846451336",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=200909050846451336",
        "title": "臨床化学",
        "material_number": "Z0312BAY",
        "jdream3_material_number": "Z0312B",
        "issn_list": [
            "0370-5633"
        ],
        "coden_list": [
            "RIKAAN"
        ],
        "publishers": [
            "日本臨床化学会"
        ]
    },
    {
        "jgid": "200909076618743172",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=200909076618743172",
        "title": "神経化学",
        "material_number": "Y0225AAP",
        "jdream3_material_number": "Y0225A",
        "issn_list": [
            "0037-3796"
        ],
        "publishers": [
            "日本神経化学会"
        ]
    },
    {
        "jgid": "200909031345115226",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=200909031345115226",
        "title": "基礎老化研究",
        "material_number": "Y0748AAD",
        "jdream3_material_number": "Y0748A",
        "issn_list": [
            "0912-8921"
        ],
        "publishers": [
            "日本基礎老化学会"
        ]
    }
]
   
  

資料情報取得

GET
/materials/{jgid},{jgid},...

J-GLOBAL IDを指定して資料情報を取得します。

パラメータ
jgid *必須 取得する基本情報のJ-GLOBAL ID(カンマ区切りで最大100まで指定可能)
lang 言語. ja => 日本語, en => 英語

レスポンス

返却されるJSONのスキーマは以下になります

application/json

{
    "description": "資料情報の配列", 
    "type": "array", 
    "items": {
        "description": "資料基本情報", 
        "properties": {
            "jgid": {
                "description": "J-GLOBAL ID", 
                "type": "string"
            }, 
            "url": {
                "description": "J-GLOBAL詳細画面のURL", 
                "type": "string"
            }, 
            "title": {
                "description": "タイトル", 
                "type": "string"
            }, 
            "material_number": {
                "description": "資料番号 (フル表記)", 
                "type": "string"
            }, 
            "jdream3_material_number": {
                "description": "資料番号 (6ケタ表記)", 
                "type": "string"
            }, 
            "issn_list": {
                "description": "ISSNのリスト", 
                "type": "array", 
                "items": {
                    "type": "string"
                }
            }, 
            "isbn_list": {
                "description": "ISBNのリスト", 
                "type": "array", 
                "items": {
                    "type": "string"
                }
            }, 
            "coden_list": {
                "description": "CODENのリスト", 
                "type": "array", 
                "items": {
                    "type": "string"
                }
            }, 
            "publishers": {
                "description": "出版団体名", 
                "type": "array", 
                "items": {
                    "type": "string"
                }
            }
        }
    }
}
 

出力例

URL
/materials/200909050846451336,200909076618743172,200909031345115226?lang=ja

application/json


   [
    {
        "jgid": "200909050846451336",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=200909050846451336",
        "title": "臨床化学",
        "material_number": "Z0312BAY",
        "jdream3_material_number": "Z0312B",
        "issn_list": [
            "0370-5633"
        ],
        "coden_list": [
            "RIKAAN"
        ],
        "publishers": [
            "日本臨床化学会"
        ]
    },
    {
        "jgid": "200909076618743172",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=200909076618743172",
        "title": "神経化学",
        "material_number": "Y0225AAP",
        "jdream3_material_number": "Y0225A",
        "issn_list": [
            "0037-3796"
        ],
        "publishers": [
            "日本神経化学会"
        ]
    },
    {
        "jgid": "200909031345115226",
        "url": "http:\/\/jglobal.jst.go.jp\/detail?JGLOBAL_ID=200909031345115226",
        "title": "基礎老化研究",
        "material_number": "Y0748AAD",
        "jdream3_material_number": "Y0748A",
        "issn_list": [
            "0912-8921"
        ],
        "publishers": [
            "日本基礎老化学会"
        ]
    }
   ]
   

5.動作可能なサンプルスクリプト

サンプル1

テキスト入力エリアに検索キーワードを入力し、プルダウンで基本情報を指定して、検索ボタンをクリックすることで、HTML形式の検索結果一覧を表示するスクリプトです。


<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<script type="text/javascript" src="https://api.jglobal.jst.go.jp/webapi/api.js.php?key=[ご利用者のWebAPIキー]"  charset="UTF-8"></script>
<script type="text/javascript">
//<![CDATA[
function api_invoke(page){
    //フォームからクエリ、カテゴリを取得
    query=document.searchForm.query.value;
    func=document.searchForm.func.value;
    //サーチオブジェクト作成
    var s = new jglobal.search();
    //ローディングのアニメーションを表示
    document.getElementById("result").innerHTML="<img src='https://jglobal.jst.go.jp/common/images/loading.gif'>";
    //検索を実行
    switch(func) {
    case "0":
        s.getHTMLforArticle("jg_callback", query, page);
        break;
    case "1":
        s.getHTMLforTerm("jg_callback", query, page);
        break;
    case "2":
        s.getHTMLforChemical("jg_callback", query, page);
        break;
    case "3":
        s.getHTMLforMaterials("jg_callback", query, page);
        break;
    }
    return false;
}
//検索実行後に呼び出される関数
function jg_callback(html){
    document.getElementById("result").innerHTML=html;
}
//ページャがクリックされたときに呼ばれる関数(この名前で呼ばれる)
function jg_change_page(page){
    api_invoke(page);
}
//]]>
</script>
</head>
<body>
WebAPIのテストページです (選択したカテゴリのHTMLを返します)
<form onsubmit="return api_invoke(1);" name="searchForm">
    <input type="text" name="query" value="検索語を入力してください">
    <select name="func">
        <option value="0">文献
        <option value="1">科学技術用語
        <option value="2">化学物質
        <option value="3">資料
    </select>
    <input type="submit" name="btnSubmit" value="検索">
</form>
この下に結果が表示されます
    <div id="result" style="background-color:#f9f9f9">挿入対象のDIV</div>
この上に結果が表示されます
</body>
</html>

サンプル2

テキスト入力エリアに検索キーワードを入力し、プルダウンで基本情報を指定して、検索ボタンをクリックすることで、JSON形式で取得した検索結果のうち、見出し語の一覧を表示するスクリプトです。


<html>
<head>
<meta http-equiv="Content-Type" content="text/html;  charset=UTF-8" />
<script type="text/javascript"  src="https://api.jglobal.jst.go.jp/webapi/api.js.php?key=[ご利用者のWebAPIキー]"  charset="UTF-8"></script>
<script type="text/javascript">
//<![CDATA[
function api_invoke(page){
    //フォームからクエリ、カテゴリを取得
    query=document.searchForm.query.value;
    func=document.searchForm.func.value;
    //サーチオブジェクト作成
    var s = new jglobal.search();
    
    //ローディングのアニメーションを表示
    document.getElementById("result").innerHTML="<img  src='https://jglobal.jst.go.jp/common/images/loading.gif'>";
    //検索を実行
    switch(func) {
    case "0":
        s.getJSONforArticle("jg_callback",  query, page);
        break;
    case "1":
        s.getJSONforTerm("jg_callback",  query, page);
        break;
    case "2":
        s.getJSONforChemical("jg_callback",  query, page);
        break;
    case "3":
        s.getJSONforMaterials("jg_callback",  query, page);
        break;
    }
    return false;
}

//検索実行後に呼び出される関数
function jg_callback(json){
if(json.error != undefined){
        document.getElementById("result").innerHTML="エラー";
        alert(json.error);
    }else{
        var html="";
        html="結果:"+json.hit_count+"件中  "+json.item_from+"件~"+json.item_to+"件目を表示<p>";
        for(i=0;i<json.items.length;i++){
            switch(json.items[i].category){
            case  'article':
                html+="<a  href='https://jglobal.jst.go.jp/detail.php?from=API&JGLOBAL_ID="+json.items[i].JGID+"'  target='_blank'>"+json.items[i].TI.J+"</a><br>";break;
            case  'term':
                html+="<a  href='https://jglobal.jst.go.jp/detail.php?from=API&JGLOBAL_ID="+json.items[i].JGID+"'  target='_blank'>"+json.items[i].TM.J+"</a><br>";break;
            case  'chemical':
                html+="<a  href='https://jglobal.jst.go.jp/detail.php?from=API&JGLOBAL_ID="+json.items[i].JGID+"'  target='_blank'>"+json.items[i].TM.J+"</a><br>";break;
            case  'materials':
                html+="<a  href='https://jglobal.jst.go.jp/detail.php?from=API&JGLOBAL_ID="+json.items[i].JGID+"'  target='_blank'>"+json.items[i].JT+"</a><br>";break;
            }
        }
        document.getElementById("result").innerHTML=html;
        jg_create_pager(json.hit_count);
    }
}
//]]>
</script>
</head>
<body>
WebAPIのテストページです (選択したカテゴリのJSONを返します)
<form onsubmit="return api_invoke(1);" name="searchForm">
    <input type="text" name="query" value="検索語を入力してください">
    <select name="func">
        <option value="0">文献
        <option value="1">科学技術用語
        <option value="2">化学物質
        <option value="3">資料
    </select>
    <input type="submit" name="btnSubmit" value="検索">
</form>
この下に結果が表示されます
    <div id="result" style="background-color:#f9f9f9">挿入対象のDIV</div>
    <div id="jg_pager"></div>
この上に結果が表示されます
</body>
</html>

6.JSON 構造体について

共通

項目名 説明
エラー種別 json.error 検索エラーの有無を格納
エラーなし:(空)
APIキー無効:"invalid key"
Referer無効:"invalid key"
未承認:"invalid key"
アクセス上限回数超え:"upper limit"
検索ヒット件数 json.hit_count ヒット件数が30件の場合は、30が入ります。
件数開始値 json.item_from 引数pageに指定された件数開始値
Page=2の場合は21
件数終了値 json.item_to 引数pageに指定された件数終了値
Page=2の場合は40
1ページ当たりの件数 json.items.length 固定値 20
基本情報種別 json.items[n].category 以下の文字列が入ります。
get***forArticleの場合:"article"
get***forTerm:の場合"term"
get***forChemicalの場合:"chemical"
get***forMaterialsの場合: "materials"

文献

項目名 構造体 説明
J-GLOBAL ID JGID json.items[n].JGID 取得したページ中のn+1件目の文献のJ-GLOBALID
DOI ID[].DOI json.items[n].ID[m].DOI 取得したページ中のn+1件目の文献のm+1件目のDOI
※DOI:Digital Object Identifier
JOI ID[].JOI json.items[n].ID[m].JOI 取得したページ中のn+1件目の文献のm+1件目のJOI
※JOI:JST Object Identifier
論文タイトル(原) TI.O json.items[n].TI.O 取得したページ中のn+1件目の文献の論文タイトル(原語)
論文タイトル(日) TI.J json.items[n].TI.J 取得したページ中のn+1件目の文献の論文タイトル(日本語)
論文タイトル(英) TI.E json.items[n].TI.E 取得したページ中のn+1件目の文献の論文タイトル(英語)
著者所属機関(日) AU[].CSJ json.items[n].AU[m].CSJ 取得したページ中のn+1件目の論文のm+1番目の著者所属機関(日本語)
著者所属機関(英) AU[].CSE json.items[n].AU[m].CSE 取得したページ中のn+1件目の論文のm+1番目の著者所属機関(英語)
著者名(日) AU[].J json.items[n].AU[m].J 取得したページ中のn+1件目の論文のm+1番目の著者(日本語もしくは全角)
著者名(英) AU[].E json.items[n].AU[m].E 取得したページ中のn+1件目の論文のm+1番目の著者(英語)

科学技術用語

項目名 構造体 説明
J-GLOBAL ID JGID json.items[n].JGID 取得したページ中のn+1件目のJ-GLOBALID
科学技術用語 TM.J json.items[n].TM.J 取得したページ中のn+1件目の科学技術用語

化学物質

項目名 構造体 説明
J-GLOBAL ID JGID json.items[n].JGID 取得したページ中のn+1件目のJ-GLOBALID
分子式 MF json.items[n].MF 取得したページ中のn+1件目の分子式
化学物質名称 TM.J json.items[n].TM.J     取得したページ中のn+1件目の化学物質名称
化学物質慣用名 KAN[] json.items[n].KAN[m] 取得したページ中のn+1件目のm+1番目の慣用名

資料

項目名 構造体 説明
J-GLOBAL ID JGID json.items[n].JGID 取得したページ中のn+1件目のJ-GLOBALID
ISSN ISN json.items[n].ISN 取得したページ中のn+1件目のISSN
出版者名 PC json.items[n].PC 取得したページ中のn+1件目の出版者名
資料名 JT json.items[n].JT 取得したページ中のn+1件目の資料名

7.検索窓の配布について

調べものサイト、研究者Webページ、ブログ等々、J-GLOBAL 以外のサイトから簡単に J-GLOBAL を検索できる、検索窓の表示スクリプトを公開いたします。下記のスクリプトを Web ページに組み込むことで、検索窓の表示が可能です。

スクリプト


<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
<div id="jglobal_searchbox">before</div>
<script type="text/javascript" src="https://api.jglobal.jst.go.jp/webapi/js/external_searchbox.js"></script>
</body>
</html>

検索窓の組み込み例

カスタマイズについて

本検索窓は次のようなカスタマイズが可能です。

  • 特定の検索タブのみを表示することができます(10種類のタブのうち、3種類のみにするなど)
  • 検索対象ごとのメッセージを変えることができます(「検索のヒント」と表示されているエリア)
  • デザインを替えることが出来ます(別途画像を用意する必要があります)

詳しくは、こちらよりお問い合わせください。

8.より高度な連携について

J-GLOBAL とのより高度な連携、例えば、制限回数の拡大や他基本情報の API 利用等を希望される場合には、こちらよりお問い合わせ下さい。双方のメリットになることを前提に、可能な連携サービスについてご相談させていただきます。

9.よくあるご質問

WebAPIキーの申請について

Q. WebAPI キーの申請には条件がありますか?
A. WebAPI キーの発行申請は、J-GLOBAL 上でMyJ-GLOBALにアカウント登録(無料)し、「WebAPI 利用規約」に同意していただくことで、どなたでも無料で行えます。
Q. アカウント登録はどのように行えばいいですか?
A. 「WebAPI ご利用の流れ」を参照ください。
Q. WebAPI キーの申請はどのように行えばいいですか?
A. 「WebAPI ご利用の流れ」を参照ください。
Q. WebAPI キーの申請をしました。いつから使えるようになりますか?
A. 申請をいただくと、JST担当者が、申請されたサイト情報(URI)の内容確認を行います。確認には、最大で1週間程度を要することがあります。WebAPI 利用規約と照らして適当でないと判断された申請については、JST担当者より、アカウント登録時のメールアドレスに別途問い合わせをさせていただくことがあります。 JST担当者が申請受付処理をしますと、登録メールアドレスに対して、完了メールを送信します。WebAPI キーの確認は再度ログインし、WebAPI リンクより確認できます。
Q. 発行された WebAPI キーをどのように埋め込めばいいですか?
A. キーが発行された後の WebAPI 画面内にサンプルスクリプトを用意していますので参考にしてください。
Q. サイト情報(URI)の入力を間違えた/サイト情報(URI)を変更したい/WebAPI をもう使わない場合はどうしたらいいですか?
A. WebAPI キーの取り消し依頼を J-GLOBAL サイト各画面のフッターにあります、「科学技術振興機構へのお問い合わせ」より行ってください。JST による取り消し処理後に完了メールが送られます。入力間違いや変更の場合は、再度 WebAPI 申請画面より利用申請を行ってください。

WebAPIの利用について

Q. どんな人が WebAPI を使うのですか?
A. WebAPI はご自身でWebサイトを管理・運営し、情報を発信している方がご利用になることを想定しています。
Q. 現在普通に J-GLOBAL を検索しています。WebAPI の公開により何か変りますか?
A. 今後、この WebAPI を組み込んだサイトが出現することで、J-GLOBAL サイトに訪れることなく J-GLOBAL上のリソースを検索できることが期待されます。J-GLOBAL サイト上の変化としては、アカウント登録や WebAPI キーの発行申請のためのリンクが増える程度で、通常の検索や詳細情報表示などのご利用にあたっては変化はありません。
Q. WebAPI で何ができますか?
A. WebAPI では J-GLOBAL サイトの画面を介すことなく、「文献」「科学技術用語」「化学物質」「資料」の各基本情報を対象にご自身が管理・運営されている Web サイト上で検索結果一覧の情報を取得できます。
Q. WebAPI利用上の注意点はありますか?
A1. API呼び出し回数が1日当たり5000回までとなっています。これを超えてアクセスしようとすると、エラーが返ります。
A2. 今回のバージョンでは検索時に同義語を自動展開しませんので、必要に応じて検索時に同義語を OR でつなぐなどをしてください。
A3. インターネットから接続可能な Web サイトのみとなります。社内イントラネットや Web ブラウザ以外の Windows アプリケーション経由ではご利用いただけません。
Q. WebAPI で論文などの詳細情報を取得するにはどうしたらいいですか?
A. 本 WebAPI では J-GLOBAL 詳細画面レベルの情報を取得することは出来ません。J-GLOBAL の詳細画面へリンクするようにお願いいたします。J-GLOBAL 詳細画面の URL は HTML 形式では埋め込まれおり、JSON 形式では J-GLOBAL ID を取得していただき、次のような形式でリンクを生成することで詳細画面へのリンクができます。
https://jglobal.jst.go.jp/detail.php?from=API&JGLOBAL_ID=[APIより取得したJ-GLOBALID]
Q. 出力形式にある JSON 形式と HTML 形式の違いはなんですか?
A. JSON 形式は検索結果情報から必要な情報を取得して、自由なレイアウトで表示したい場合に向いています。HTML 形式では返却された結果をそのまま埋め込むことができるため、手軽に検索結果を表示することができます。サンプルスクリプトなどを参考ください。
Q. 今回対象となっている4種類以外の、研究者や特許などの基本情報の対応予定はありますか?
A. ご利用者のお申し出に対して、WebAPI の利用目的や利用イメージをお伺いした上で、提携の覚書を交わす等、個別に対応いたします。