Quickstart

5 分で Momonga Search API を呼び始めるための手順です。

API キーを取得する

momongasearch.com からサインアップします。
管理アプリで API キーを発行します。
すべてのリクエストで Authorization: Bearer {API_KEY} ヘッダーを付けます。

ベース URL:

https://api.momongasearch.com/v1

企業を検索する

curl -s "https://api.momongasearch.com/v1/issuers/search?q=%E4%B8%89%E8%8F%B1%E5%95%86%E4%BA%8B" \
  -H "Authorization: Bearer $MOMONGA_API_KEY"

レスポンス例:

{
  "results": [
    {
      "security_code": "8058",
      "edinet_code": "E02529",
      "name": "三菱商事株式会社",
      "market": "プライム",
      "sector": "卸売業"
    }
  ]
}

企業の公表資料を一覧する

curl -s "https://api.momongasearch.com/v1/documents?security_codes=8058&limit=10" \
  -H "Authorization: Bearer $MOMONGA_API_KEY"

documents は新着 discovery timeline の降順で返ります。published_at が後から補完されても、一覧の順序が不必要に変わらないように設計されています。

自然文で文書を検索する

API リクエストには、個人情報、秘密情報、未公表の重要事実その他の機密情報を含めないでください。検索クエリ及び API 利用ログは、サービス提供、品質改善、不正利用対応、障害調査及び利用傾向分析のため保存・分析される場合があります。

curl -s -X POST "https://api.momongasearch.com/v1/search/documents" \
  -H "Authorization: Bearer $MOMONGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "資源価格変動リスクへの対応方針",
  "security_codes": [
    "8058",
    "8031",
    "8001",
    "8002",
    "8053"
  ],
  "top_k": 10
}'

キーワード一致だけでなく意味検索を使うため、本文に同じ単語がなくても近い意味の記述を拾えます。

目次を取得し、必要なセクションだけ読む

curl -s "https://api.momongasearch.com/v1/documents/{document_id}/toc" \
  -H "Authorization: Bearer $MOMONGA_API_KEY"

curl -s "https://api.momongasearch.com/v1/documents/{document_id}/content?sections=sec-b2c3d4e5" \
  -H "Authorization: Bearer $MOMONGA_API_KEY"

section_id は /toc または検索結果の matches[] から取得した値をそのまま指定します。/toc は課金対象外です。まず目次と token_count を見て、LLM に渡すセクションを選んでください。