API Documentation

Access our emoji collection programmatically through our REST API endpoints.

GET Get a Specific Emoji

Retrieve a specific emoji by its name.

https://emoji-app.com/api/emoji/{emoji_name}

curl https://emoji-app.com/api/emoji/smiling%20face

Response:

{
    "emoji": "😊",
    "name": "smiling face",
    "count": 42
}

GET Get a Random Emoji

Get a random emoji from our collection.

https://emoji-app.com/api/random

curl https://emoji-app.com/api/random

Response:

{
    "emoji": "🚀",
    "name": "rocket",
    "count": 17
}

GET View Popular Emojis

Get the top 10 most used emojis with their usage statistics.

https://emoji-app.com/api/stats

curl https://emoji-app.com/api/stats

Response:

[
    {
        "emoji": "😊",
        "name": "smiling face",
        "copy_count": 42,
        "api_count": 12,
        "last_used": "2024-01-01 12:00:00"
    },
    // ... more emojis
]

GET Record Emoji Copy

Record when an emoji is copied from the website.

https://emoji-app.com/api/increment/{emoji_name}

curl https://emoji-app.com/api/increment/rocket

Response:

{
    "success": true,
    "count": 18
}