Kaomojis पब्लिक API
सबसे बड़ी जापानी काओमोजी JSON API (54,000+ प्रविष्टियाँ, 12 भाषाएँ, OpenAPI 3.0)। मुफ्त, CORS सक्षम।
क्विक स्टार्ट (30 सेकंड)
कोई ऑथ नहीं, कोई API key नहीं। नीचे दिए गए कमांड को टर्मिनल में पेस्ट करें।
# 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 types।
// 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
डेमो ऐप्स
तुरंत कॉपी-पेस्ट करने योग्य तीन न्यूनतम उदाहरण।
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 |
रेट लिमिट और कैशिंग
वर्तमान लक्ष्य: 60 req/min/IP। Cache-Control हेडर का सम्मान करें। दुरुपयोग IP-स्तर पर ब्लॉक किया जाता है।
OpenAPI 3.0 स्पेसिफिकेशन
पूर्ण स्पेक /api/v1/openapi.json पर उपलब्ध है। Swagger UI, Redoc, Stoplight, Postman में सीधे इम्पोर्ट करें।
→ /api/v1/openapi.jsonसामान्य प्रश्न
क्या व्यावसायिक उपयोग कर सकते हैं?
हाँ, MIT जैसी शर्तों पर। kaomojis.jp पर बैकलिंक अनुशंसित है पर अनिवार्य नहीं।
क्या API key चाहिए?
नहीं। API सार्वजनिक और बिना ऑथ के है।
डेटा कितनी बार अपडेट होता है?
रोज़ से साप्ताहिक। कुशल कैशिंग के लिए Cache-Control का पालन करें।
क्या SDK npm पर है?
अभी प्री-रिलीज़/प्राइवेट है। सार्वजनिक रिलीज़ के बाद @kaomojis/client नाम से उपलब्ध होगा।
योगदान और प्रतिक्रिया
GitHub issue खोलें या [email protected] पर ईमेल करें। आपकी रचना देखने की प्रतीक्षा है।
अंतिम अपडेट: 2026-04-15