The API is in public beta and is subject to change. We’ll do our best to minimize breaking changes during this period.

​
Base URL

emojis.com’s API is built on REST principles and is exclusively served over HTTPS to ensure data security and privacy. Unencrypted HTTP requests are not supported.

The Base URL for all API endpoints is:

Terminal
https://api.emojis.com/v1

​
API Key

To authenticate you will need an API key which you can create and manage in the dashboard.

API keys follow the format below:

.env
EMOJIS_API_KEY=emojis_xxxxxxxx

Remember that your API key is a secret! Do not share it with others, or expose it in any client-side code (browsers, mobile apps). To protect your account’s security, we may automatically disable any API key that has leaked publicly.

Production requests must be routed through your own backend server where your API key can be securely loaded from an environment variable or credential management service.

​
Authentication

To authenticate, all API requests should include your API key in an Authorization HTTP header as follows:

Terminal
Authorization: Bearer emojis_xxxxxxxx