API ドキュメント

okazuri-search-api の公開サーバーです。認証は要りません。

はじめに

ベース URL は https://okazuri.nae.quest/api。すべて GET で、JSON(/romaji と /health はテキスト)を返します。不正なリクエストは 422 と {"detail": "..."} です。

curl "https://okazuri.nae.quest/api/okazuri/search?q=快楽天+2026+11"

各サイトの作品を検索します。クエリはまずローマ字にされ、題名のローマ字と全部の語が合うものを返します。日本語のクエリには英語訳(translation)、日本語を含まないクエリには日本語訳(translationJa)の題名の作品も含まれます。

パラメータ
q検索語。必須、1〜300 文字。空白で語を分けます。
liveoff: DB だけで答える。diff(既定): 未取得か古い組み合わせだけサイトに聞く。on: 全サイトに聞く。
limit結果の最大数(1〜100)。
exclude除くサイトの名前(カンマ区切り)。
translatorauto(既定) / hitomi / google / none。翻訳の題名でも探すか、どこで訳すか。
GET /api/okazuri/search?q=快楽天+2026+7
{
  "input": "快楽天 2026 7",
  "query": "kairakuten 2026 7",
  "total": 12,
  "results": [
    { "website": "DLsite", "isLegal": true, "url": "https://www.dlsite.com/...",
      "title": "COMIC快楽天 2026年11月号", "titleRomaji": "comic kairakuten 2026 nen 11 gatsu gou" }
  ],
  "translation": { "text": "COMIC Kairakuten", "source": "Hitomi" },
  "sites": [ { "website": "DLsite", "status": "searched", "count": 30 } ]
}

GET/api/okazuri/sites

検索の対象のサイトと、いま検索しているかを返します。

GET /api/okazuri/sites
[ { "name": "DLsite", "isLegal": true, "support": "ready", "hasSearch": true, "japanese": true, "active": true } ]

Hitomi.La を除いたサイトだけを検索します(/okazuri/search と同じ形)。

パラメータ
q検索語。
GET /api/hitomila/search?q=nine+lives

GET/api/{hitomila,google,auto}/translate

題名の翻訳です。日本語の語は英語に、英語の語は日本語に訳します。auto は Hitomi.La、だめなら Google 翻訳。

パラメータ
q翻訳する語。必須。
liveoff / diff(既定) / force。
GET /api/auto/translate?q=姉弟

GET/api/romaji

日本語のローマ字を text/plain で返します。

パラメータ
qテキスト。必須。
loanwordsromaji(既定) / english: ひらがなの外来語の書き方。
GET /api/romaji?q=チートアイテム管理局のお仕事
chiito aitemu kanrikyoku no oshigoto

キャッシュ

Cloudflare が成功(200)の応答を保持します。検索は 5 分、サイト一覧は 1 時間、翻訳とローマ字は 1 日です。live=on、エラー、/health は保持されません。応答の Cache-Control と cf-cache-status で確認できます。

正確な仕様は GitHub の API.md にあります。