> ## Documentation Index
> Fetch the complete documentation index at: https://emojis.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Understand general concepts and how to work with the emojis.com API.

<Note>
  The API is in public beta and is subject to change. We'll do our best to minimize breaking changes during this period.
</Note>

## Base URL

[emojis.com](https://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:

```bash 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](https://www.emojis.com/settings/api-keys).

API keys follow the format below:

```bash .env
EMOJIS_API_KEY=emojis_xxxxxxxx
```

<Warning>
  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.
</Warning>

## Authentication

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

```bash Terminal
Authorization: Bearer emojis_xxxxxxxx
```