API pública Kaomojis

Una API JSON gratuita, con CORS habilitado, al mayor catálogo de kaomoji japoneses (61.000+, 12 idiomas, OpenAPI 3.0).

61.000+ entradas · El mayor catálogo de kaomoji japoneses online 12 idiomas · keywords / usage / note totalmente localizados OpenAPI 3.0 · Compatible con Swagger UI, Redoc, Stoplight, Postman Gratis y con CORS · Sin auth, llama directamente desde el navegador

Inicio rápido (30 segundos)

Sin autenticación ni clave API. Pega los comandos siguientes en tu terminal.

# 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"

SDK JavaScript / TypeScript

@kaomojis/client funciona en Node.js 18+ y navegadores modernos. Cero dependencias, tipos TypeScript completos.

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

Aplicaciones de demostración

Tres ejemplos mínimos listos para copiar y pegar.

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

Endpoints

Todos los endpoints devuelven JSON, usan GET y tienen CORS habilitado (`*`).

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

Límites de uso y caché

Objetivo actual de uso razonable: 60 req/min/IP. Respeta las cabeceras Cache-Control. Se bloquea el abuso por IP.

Especificación OpenAPI 3.0

Especificación completa en /api/v1/openapi.json — funciona con Swagger UI, Redoc, Stoplight o Postman.

→ /api/v1/openapi.json

Preguntas frecuentes

¿Puedo usarla comercialmente?

Sí, bajo términos tipo MIT. Se agradece (pero no es obligatorio) un enlace de vuelta a kaomojis.jp.

¿Necesito una clave API?

No. La API es pública y sin autenticación.

¿Con qué frecuencia se actualiza?

De diario a semanal. Respeta Cache-Control para cachear eficientemente.

¿El SDK está en npm?

Actualmente es pre-release privado. Tras el lanzamiento se publicará como @kaomojis/client.

Contribuir y feedback

Abre un issue en GitHub o escríbenos a [email protected]. Nos encantaría ver lo que construyes.

[email protected] About Methodology /request

Última actualización: 2026-04-15