Emoticons API

Contribute to this Project!

Feel free to fork and star this repo to contribute and help improve the project.

Introduction

Welcome to the Emoticons API documentation. This API provides access to a collection of emoticons organized by different types. All endpoints are freely accessible and don't require authentication.

Example Emoticons

(⌐■_■)

༼つ◕_◕༽つ

(╯°□°）╯︵ ┻━┻

ʕ•ᴥ•ʔ

Endpoints

Get All Emoticons

GET /api/data

Returns all available emoticons across all categories.

Response Example:

{ "happy": ["(◠‿◠)", "ʘ‿ʘ", ...], "sad": ["(︶︹︺)", "（；´д｀）ゞ", ...], // Other categories }

Get Emoticons by Type

GET /api/data/type/:type

Returns emoticons of a specific type.

Available Types:

Parameters

Parameter	Type	Description
type	string	Type of emoticons (e.g., 'happy', 'sad')

Response Example:

{ "happy": ["(◠‿◠)", "ʘ‿ʘ", "ಠ‿ಠ"] }

Error Responses

Status Code	Description
404	Data type not found
500	Server error

Rate Limiting

The API is hosted on Vercel's free tier with the following limitations:

• Maximum of 100 serverless function invocations per day
• Maximum execution duration of 10 seconds per request
• Maximum payload size of 4.5 MB

Examples

Fetch all emoticons

fetch('https://emoticons-api.vercel.app/api/data') .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));

Fetch happy emoticons

fetch('https://emoticons-api.vercel.app/api/data/type/happy') .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));