Kaomojis Public API

API JSON gratis dengan CORS untuk katalog kaomoji Jepang terbesar (61.000+, 12 bahasa, OpenAPI 3.0).

61.000+ entri · Katalog kaomoji Jepang terbesar online 12 bahasa · keywords / usage / note sepenuhnya dilokalisasi OpenAPI 3.0 · Kompatibel dengan Swagger UI, Redoc, Postman Gratis & CORS · Tanpa auth, panggil langsung dari browser

Mulai cepat (30 detik)

Tanpa auth, tanpa API key. Tempel perintah di bawah ke 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 berjalan di Node.js 18+ dan browser modern. Nol dependensi, tipe TypeScript lengkap.

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

Aplikasi demo

Tiga contoh minimal siap salin-tempel.

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

Endpoint

Semua endpoint mengembalikan JSON, metode GET, dan 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

Batas laju & cache

Target fair-use: 60 req/mnt/IP. Hormati header Cache-Control. Penyalahgunaan diblokir per IP.

Spesifikasi OpenAPI 3.0

Spec lengkap di /api/v1/openapi.json — kompatibel dengan Swagger UI, Redoc, Stoplight, Postman.

→ /api/v1/openapi.json

FAQ

Boleh untuk komersial?

Ya, dengan lisensi mirip MIT. Tautan balik ke kaomojis.jp dihargai tapi tidak wajib.

Perlu API key?

Tidak. API bersifat publik dan tanpa autentikasi.

Seberapa sering data diperbarui?

Harian hingga mingguan. Hormati Cache-Control untuk caching efisien.

Apakah SDK ada di npm?

Saat ini pra-rilis/privat. Setelah rilis publik akan tersedia sebagai @kaomojis/client.

Kontribusi & umpan balik

Buka issue GitHub atau kirim email ke [email protected]. Kami ingin melihat karyamu.

[email protected] About Methodology /request

Pembaruan terakhir: 2026-04-15