Kaomojis 公共 API
最大規模的日本顏文字 JSON API（61,000+ 條、12 種語言），免費、開放 CORS、OpenAPI 3.0。
61,000+ 條 · 涵蓋全面的日本顏文字資料庫 12 種語言 · keywords / usage / note 全量在地化 OpenAPI 3.0 · 相容 Swagger UI / Redoc / Postman 免費且開放 CORS · 免驗證、瀏覽器可直接呼叫
快速入門（30 秒）
无需鉴权或 API key。直接把以下命令粘贴到终端。
# random kaomoji
curl "https://kaomojis.jp/api/v1/kaomojis/random?locale=en"
# search
curl "https://kaomojis.jp/api/v1/kaomojis/search?q=love&locale=en"
# paginated list of cute kaomojis
curl "https://kaomojis.jp/api/v1/kaomojis?category=cute&page=1&limit=20&locale=en"
# full category catalog
curl "https://kaomojis.jp/api/v1/categories?type=emotion&locale=en"JavaScript / TypeScript SDK
@kaomojis/client 支持 Node.js 18+ 与现代浏览器，零依赖、完整 TS 类型。
// after public release
npm install @kaomojis/client
import { KaomojisClient } from '@kaomojis/client';
const client = new KaomojisClient({ defaultLocale: 'en' });
const { data } = await client.random({ count: 3 });
console.log(data[0].text); // e.g. "(*´ω`*)"
Source: sdk/javascript/ ·
License: MIT
Chrome Extension (PoC)
Prefer a no-code client? The Kaomojis extension uses the same public API in a one-click popup.
Discord Bot (PoC)
Drop the same API into any Discord server via slash commands — self-hostable in five minutes.
示範應用
三个可立即运行的最小示例，复制后即可使用。
Browser (vanilla JS)
Random generator widget, drop-in HTML file.
research/phase558_demo_random.html Node.js CLI
node demo.js random|search|categories|id
research/phase558_demo_cli.js Discord bot
discord.js skeleton with 3 slash commands.
research/phase558_demo_discord_bot.js 端點列表
所有端点均为 GET + JSON + CORS(*)。
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/kaomojis | List kaomojis (paginated, filterable) |
| GET | /api/v1/kaomojis/:id | Get a kaomoji by numeric id |
| GET | /api/v1/kaomojis/random | Random kaomoji(s) (up to 10) |
| GET | /api/v1/kaomojis/search | Keyword search ranked by relevance |
| GET | /api/v1/random | Shorthand alias for /kaomojis/random |
| GET | /api/v1/search | Shorthand alias for /kaomojis/search |
| GET | /api/v1/categories | List categories with kaomoji counts |
| GET | /api/v1/openapi.json | OpenAPI 3.0 specification |
速率限制與快取
目前的公平使用上限：每 IP 60 次/分鐘。請遵循 Cache-Control 標頭。濫用將按 IP 封鎖。
OpenAPI 3.0 規範
完整規範位於 /api/v1/openapi.json，可直接匯入 Swagger UI / Redoc / Stoplight / Postman。
→ /api/v1/openapi.json常見問題
可以商用嗎？
可以，採用 MIT 式授權。鼓勵但非必需保留連回 kaomojis.jp 的連結。
需要 API key 嗎？
不需要，目前 API 公開且無需驗證。
資料多久更新？
每日到每週更新。請遵循 Cache-Control 以高效快取。
SDK 發布到 npm 了嗎？
目前為預發布版，正式發布後將作為 @kaomojis/client 提供。
貢獻與回饋
歡迎至 GitHub 開 Issue 或寄信至 [email protected]。期待看到你的作品。
最後更新：2026-04-15