Developer API

A lightweight, read-only JSON API for emoji search and lookup. Create a free API key, send a request, get emojis. No SDK required.

Your API keys

Keys are secret — treat them like passwords. Your tier is Free; new keys inherit it.

Authentication

Pass your key on every request, either as a Bearer token (preferred) or a query parameter:

Authorization: Bearer YOUR_API_KEY
— or —
?api_key=YOUR_API_KEY

Requests without a valid key return 401. Over-quota requests return 429 with a retry_after (seconds).

Endpoints

GET /api/v1/search

Search emojis. Params: q (required), limit (1–50, default 20).

curl "https://www.fastemoji.com/api/v1/search?q=happy&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /api/v1/emoji/{slug}

Look up a single emoji by its slug. Returns 404 if unknown.

curl "https://www.fastemoji.com/api/v1/emoji/grinning-face" \
  -H "Authorization: Bearer YOUR_API_KEY"

Rate limits

Tier	Per minute	Per day
Free	60	1,000
Premium	600	50,000

Exceeding a limit returns HTTP 429 with { error, limit, retry_after }. Go Premium for higher limits.

Embed a search widget

Drop this HTML on any page for an instant emoji search box powered by your key.

<!-- FastEmoji search widget -->
<div id="fastemoji-widget" style="max-width:420px;font-family:system-ui,sans-serif"></div>
<script>
(function () {
  var API = "https://www.fastemoji.com/api/v1/search";
  var KEY = "YOUR_API_KEY";
  var root = document.getElementById("fastemoji-widget");
  root.innerHTML =
    '<input id="fe-q" placeholder="Search emojis…" ' +
    'style="width:100%;padding:10px;border:1px solid #ccc;border-radius:8px;font-size:15px">' +
    '<div id="fe-out" style="font-size:26px;line-height:1.8;margin-top:8px"></div>';
  var t;
  document.getElementById("fe-q").addEventListener("input", function (e) {
    clearTimeout(t);
    var q = e.target.value.trim();
    t = setTimeout(function () {
      if (!q) { document.getElementById("fe-out").textContent = ""; return; }
      fetch(API + "?q=" + encodeURIComponent(q) + "&limit=20", {
        headers: { Authorization: "Bearer " + KEY }
      })
        .then(function (r) { return r.json(); })
        .then(function (d) {
          document.getElementById("fe-out").innerHTML = (d.results || [])
            .map(function (x) {
              return '<a href="https://www.fastemoji.com/' + x.slug + '" target="_blank" ' +
                'style="text-decoration:none;cursor:pointer" title="' + x.title + '">' +
                x.icon + '</a>';
            })
            .join(" ");
        });
    }, 250);
  });
})();
</script>

Note: the key is visible in client-side HTML — use a Free-tier key for public embeds.