API publique Kaomojis

Une API JSON gratuite avec CORS activé pour le plus grand catalogue de kaomoji japonais (48 000+, 12 langues, OpenAPI 3.0).

48 000+ entrées · Le plus grand catalogue de kaomoji japonais en ligne 12 langues · keywords / usage / note entièrement localisés OpenAPI 3.0 · Compatible Swagger UI, Redoc, Stoplight, Postman Gratuit & CORS · Sans auth, appelez directement depuis le navigateur

Démarrage rapide (30 secondes)

Pas d'authentification ni de clé API. Collez les commandes ci-dessous dans votre 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 fonctionne sur Node.js 18+ et les navigateurs modernes. Zéro dépendance, types TypeScript complets.

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

Applications de démonstration

Trois exemples minimaux prêts à copier-coller.

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

Tous les endpoints renvoient du JSON, utilisent GET et ont CORS activé (`*`).

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

Limites de débit & cache

Objectif actuel : 60 req/min/IP. Respectez les en-têtes Cache-Control. Les abus sont bloqués par IP.

Spécification OpenAPI 3.0

Spec complet sur /api/v1/openapi.json — compatible Swagger UI, Redoc, Stoplight, Postman.

→ /api/v1/openapi.json

FAQ

Puis-je l'utiliser commercialement ?

Oui, sous une licence type MIT. Un lien retour vers kaomojis.jp est apprécié mais non obligatoire.

Ai-je besoin d'une clé API ?

Non. L'API est publique et sans authentification.

À quelle fréquence les données sont-elles mises à jour ?

Du quotidien à l'hebdomadaire. Respectez Cache-Control pour cacher efficacement.

Le SDK est-il sur npm ?

Actuellement en pré-version / privé. Il sera publié sous @kaomojis/client après le lancement public.

Contribuer & retour

Ouvrez une issue GitHub ou écrivez à [email protected]. Nous serions ravis de voir ce que vous construisez.

[email protected] About Methodology /request

Dernière mise à jour : 2026-04-15