Kaomojis Public API

Бесплатный JSON API с CORS к крупнейшему каталогу японских каомодзи (48 000+, 12 языков, OpenAPI 3.0).

48 000+ записей · Крупнейший онлайн-каталог японских каомодзи 12 языков · keywords / usage / note полностью локализованы OpenAPI 3.0 · Совместимо со Swagger UI, Redoc, Stoplight, Postman Бесплатно · CORS · Без авторизации, вызов прямо из браузера

Быстрый старт (30 секунд)

Без авторизации и API-ключа. Вставьте команды ниже в терминал.

# 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+ и современных браузерах. Без зависимостей, полные TypeScript-типы.

// 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.

Use the Chrome Extension →

Discord Bot (PoC)

Drop the same API into any Discord server via slash commands — self-hostable in five minutes.

Add to Discord →

Демо-приложения

Три минимальных примера, готовых к копированию.

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

Эндпоинты

Все эндпоинты отвечают JSON, метод GET, 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

Ограничения и кэширование

Текущая цель: 60 запросов/мин/IP. Соблюдайте заголовки Cache-Control. Злоупотребления блокируются по IP.

Спецификация OpenAPI 3.0

Полная спецификация — /api/v1/openapi.json. Открывается в Swagger UI, Redoc, Stoplight, Postman.

→ /api/v1/openapi.json

Частые вопросы

Можно ли использовать коммерчески?

Да, на условиях типа MIT. Обратная ссылка на kaomojis.jp приветствуется, но не обязательна.

Нужен ли API-ключ?

Нет. API публичный, без авторизации.

Как часто обновляются данные?

Ежедневно до еженедельно. Уважайте Cache-Control для эффективного кэширования.

SDK опубликован в npm?

Сейчас предрелиз/приватный. После публичного релиза появится как @kaomojis/client.

Контрибьюция и обратная связь

Заведите issue на GitHub или напишите на [email protected]. Мы будем рады увидеть ваши проекты.

[email protected] About Methodology /request

Последнее обновление: 2026-04-15