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"GET/api/okazuri/search
各サイトの作品を検索します。クエリはまずローマ字にされ、題名のローマ字と全部の語が合うものを返します。日本語のクエリには英語訳(translation)、日本語を含まないクエリには日本語訳(translationJa)の題名の作品も含まれます。
| パラメータ | |
|---|---|
q | 検索語。必須、1〜300 文字。空白で語を分けます。 |
live | off: DB だけで答える。diff(既定): 未取得か古い組み合わせだけサイトに聞く。on: 全サイトに聞く。 |
limit | 結果の最大数(1〜100)。 |
exclude | 除くサイトの名前(カンマ区切り)。 |
translator | auto(既定) / 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 } ]GET/api/hitomila/search
Hitomi.La を除いたサイトだけを検索します(/okazuri/search と同じ形)。
| パラメータ | |
|---|---|
q | 検索語。 |
GET /api/hitomila/search?q=nine+livesGET/api/{hitomila,google,auto}/translate
題名の翻訳です。日本語の語は英語に、英語の語は日本語に訳します。auto は Hitomi.La、だめなら Google 翻訳。
| パラメータ | |
|---|---|
q | 翻訳する語。必須。 |
live | off / diff(既定) / force。 |
GET /api/auto/translate?q=姉弟GET/api/romaji
日本語のローマ字を text/plain で返します。
| パラメータ | |
|---|---|
q | テキスト。必須。 |
loanwords | romaji(既定) / 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 にあります。