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