@extends('site.layout') @section('title', 'API Docs - Dewemoji') @section('meta_description', 'Dewemoji API docs for emoji search, categories, license verification, activation, and system endpoints.') @push('head') @endpush @push('jsonld') @endpush @section('content')
Public / Documentation

API Documentation

Emoji API Docs

Read-only API with search, categories, and emoji detail. Responses are cacheable and include ETag.

{{ url('/v1') }}

Authentication

Free tier is public with daily caps. Pro unlocks higher limits with license key.

Authorization: Bearer YOUR_LICENSE_KEY
?key=YOUR_LICENSE_KEY
  • Authorization (recommended)
  • X-License-Key (also supported)
  • X-Account-Id (optional usage association)

Plans & limits

Tier Page size cap Daily cap Notes
Free 20 ~30 (page-1, distinct) Cached responses do not count.
Pro 50 5,000 / day / license Up to 3 Chrome profiles.

Endpoints

  • /emojis — search & paginate
  • /emoji?slug=<slug> — single emoji (query)
  • /emoji/<slug> — single emoji (pretty URL)
  • /categories — category map
  • /license/verify — license check
  • /license/activate — bind profile
  • /license/deactivate — unbind profile

GET /emojis

Search across name, category, aliases, and EN/ID keywords.

Query Param Type Description Default
q / querystringKeyword search (AND match).empty
categorystringTop-level category label.all
subcategorystringSubcategory slug.empty
pagenumber1-based page.1
limitnumberItems per page (max 50).20
curl "<BASE_URL>/emojis?q=love&category=Smileys%20%26%20Emotion&limit=20&page=1"

GET /emoji and /emoji/<slug>

curl "<BASE_URL>/emoji/smiling-face-with-smiling-eyes"

GET /categories

curl "<BASE_URL>/categories"

Try it

Demo request is limited to page=1 and limit=10.

Errors & caching

  • 400 — invalid_request
  • 401 — invalid_key
  • 404 — not_found
  • 429 — rate_limited

Responses may include ETag and Cache-Control: public, max-age=300.

@push('scripts') @endpush @endsection