Kaomojis 공개 API

최대 규모의 일본 카오모지 JSON API (54,000+ 항목, 12개 언어, OpenAPI 3.0). 무료, CORS 활성화.

54,000+ 항목 · 온라인에서 가장 큰 일본 카오모지 카탈로그 12개 언어 · keywords / usage / note 완전 현지화 OpenAPI 3.0 · Swagger UI, Redoc, 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 →

데모 앱

바로 복사해 사용할 수 있는 최소 예제 3종.

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 키가 필요한가요?

필요 없습니다. 현재는 공개·무인증입니다.

데이터 갱신 주기는?

매일~매주 갱신. Cache-Control 헤더를 따라 효율적으로 캐시해 주세요.

SDK가 npm에 있나요?

현재는 프리릴리스/프라이빗입니다. 공개 후 @kaomojis/client 로 배포 예정입니다.

기여와 피드백

GitHub Issue 또는 [email protected] 로 연락 주세요. 여러분의 작품을 보고 싶습니다.

[email protected] About Methodology /request

최종 업데이트: 2026-04-15