Sports Emojis API

Getting started

Bring the right reaction into the conversation.

The Sports Emojis API is designed for bots, community tools, match centres and fan experiences that need to surface a relevant sports reaction quickly. Start with a public search or a known collection, then retrieve a specific emoji when an account holder chooses to use it.

Every endpoint returns JSON with a predictable data envelope. Public results deliberately describe the library without exposing copyable text or original media. Personal keys unlock individual content requests and account-level usage only.

Use a personal API key for protected requests.

Content and usage endpoints need a personal key. Create one from your account settings, store it in your server or integration’s secret store, and send it in the Authorization header. You only see the key once—create a new one if it is lost or exposed.

Authorization: Bearer se_your_personal_key

1Create an account and open Settings → API.
2Name and create a key for your integration.
3Send the key as a Bearer token; never place it in a public URL.

Create an account

Built for useful integrations, not bulk extraction.

Discovery requests are rate-limited. Authenticated content access is limited to 100 unique emojis per account per day and resets at midnight in the application timezone. Requesting the same emoji again on the same day does not use another content allowance entry.

429 Too Many Requests

Slow down and retry after the rate-limit window or daily content reset.

401 Unauthorized

Add a valid personal key to the Bearer token header, or create a replacement key.

Endpoints

GET

Search emojis

Search names, slugs and related tags. A query must be at least two characters; results are capped at 20.

GET https://sportsemojis.com/api/v1/search?q=arsenal

Example response

{
  "data": [
    {
      "id": 42,
      "name": "Arsenal celebration",
      "slug": "arsenal-celebration",
      "type": "animated",
      "page_url": "https://sportsemojis.test/emoji/arsenal-celebration",
      "tags": [{ "name": "Arsenal", "slug": "arsenal" }]
    }
  ],
  "meta": { "limit": 20 }
}

GET

Browse a tag

Request a public collection directly when you already know its slug. Like search, it returns a maximum of 20 discovery results.

GET https://sportsemojis.com/api/v1/tags/football/emojis

Example response

{
  "data": [{ "id": 8, "name": "Matchday", "slug": "matchday", "type": "image" }],
  "meta": {
    "tag": { "name": "Football", "slug": "football" },
    "limit": 20
  }
}

GET Bearer token

Get emoji content

Use a personal key to retrieve a single approved emoji. Text emoji returns JSON; images and GIFs are returned as a download.

GET https://sportsemojis.com/api/v1/emojis/{slug}/content

Authorization: Bearer se_your_personal_key

Example response

{
  "data": {
    "id": 42,
    "slug": "arsenal-celebration",
    "name": "Arsenal celebration",
    "content": "🏆"
  }
}

Account access required

Create an account to generate a personal key and unlock this endpoint.

Create an account

GET Bearer token

Check usage

See how much of today’s unique-content allowance remains. Re-requesting the same emoji does not use another allowance entry.

GET https://sportsemojis.com/api/v1/usage

Authorization: Bearer se_your_personal_key

Example response

{
  "data": {
    "content_accesses_used": 12,
    "content_accesses_remaining": 88,
    "content_accesses_limit": 100,
    "resets_at": "2026-07-31T00:00:00+01:00"
  }
}

Account access required

Create an account to generate a personal key and unlock this endpoint.

Create an account