emojikitchen.dev APIemojikitchen.dev ↗
Access metadata for 619 emojis and their Google Emoji Kitchen combinations. Search by keyword, look up by codepoint, or retrieve all paired mashup URLs.
curl -X GET 'https://api.parse.bot/scraper/88538791-a6a2-44cd-91a9-51d2b95c295e/get_combinations?limit=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Extract all emojis and their unique combinations. Returns metadata for 619 emojis and unique paired combinations extracted from the site's data bundle. Due to data size, only a subset of total combinations is returned.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of combinations to return. Useful for testing or pagination. Omitting returns all available combinations. |
{
"type": "object",
"fields": {
"emojis": "array of emoji objects with codepoint, alt, emoji, category, subcategory, keywords",
"combinations": "array of combination objects with url, alt, left_emoji, left_codepoint, right_emoji, right_codepoint, date, is_latest",
"total_emojis": "integer count of all known emojis",
"total_combinations_found": "integer count of combinations returned"
},
"sample": {
"data": {
"emojis": [
{
"alt": "coffee",
"emoji": "☕",
"category": "food & drink",
"keywords": [
"hot_beverage",
"beverage",
"caffeine"
],
"codepoint": "2615",
"subcategory": "drink"
}
],
"combinations": [
{
"alt": "coffee-coffee",
"url": "https://www.gstatic.com/android/keyboard/emojikitchen/20201001/u2615/u2615_u2615.png",
"date": "20201001",
"is_latest": true,
"left_emoji": "☕",
"right_emoji": "☕",
"left_codepoint": "2615",
"right_codepoint": "2615"
}
],
"total_emojis": 619,
"total_combinations_found": 5
},
"status": "success"
}
}About the emojikitchen.dev API
The Emoji Kitchen API exposes metadata for 619 emojis and their paired mashup combinations from Google's Emoji Kitchen library across 3 endpoints. Use get_combinations to retrieve all available combination objects — each including a rendered image URL, left and right emoji codepoints, and a date field — or use get_emoji_details to pull everything known about a single emoji by its Unicode codepoint.
Endpoints and Data Coverage
The API provides three endpoints. get_combinations returns two parallel arrays: an emojis array (each object carrying codepoint, alt, emoji, category, subcategory, and keywords) and a combinations array (each object carrying url, alt, left_emoji, left_codepoint, right_emoji, right_codepoint, date, and is_latest). The optional limit parameter caps the number of combination objects returned, which is useful when you only need a sample. The response also includes total_emojis and total_combinations_found integer counts so you can gauge coverage without iterating the full arrays.
Searching and Filtering Emojis
search_emojis accepts a required query string and performs a case-insensitive partial match against both the emoji's alt name and its keywords array. The response is a matches array of emoji metadata objects in the same shape as those returned by get_combinations. This endpoint is suited for autocomplete, tag-based lookup, or filtering by concept (e.g., querying 'cat' or 'fire').
Per-Emoji Detail Lookup
get_emoji_details takes a required codepoint parameter in lowercase hex format — multi-codepoint emojis use dash-separated values (e.g., '1f1e6-1f1fa'). The response returns all six metadata fields plus a combinations array scoped to that specific emoji. Note that combinations may be empty for emojis that fall outside the available data subset, so consuming code should handle an empty array gracefully.
- Rendering a mashup image picker in a chat app using combination
urlfields returned byget_combinations - Building an emoji autocomplete widget backed by
search_emojismatching onkeywords - Displaying a 'related combinations' panel for any emoji detail page using
get_emoji_details - Generating a static catalog of all Emoji Kitchen mashups by iterating
get_combinationswith alimitfor pagination - Filtering combinations by
dateoris_latestto surface only the most recent Google Emoji Kitchen artwork - Creating an emoji category browser by grouping
categoryandsubcategoryfields from theemojisarray
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does emojikitchen.dev have an official developer API?+
What does the `is_latest` field on a combination object indicate?+
is_latest boolean alongside a date field. When is_latest is true, that combination URL represents the most recent artwork Google has produced for that emoji pair. Older artwork for the same pair will have is_latest set to false, so you can filter to just the newest renders when multiple versions exist.Does `get_combinations` return all 150,000+ known Emoji Kitchen combinations?+
total_combinations_found in the response reflects the count actually returned. You can fork this API on Parse and revise it to extend the data window or add an offset-based pagination parameter to page through the full combination set.Can I look up combinations between two specific emojis directly?+
get_emoji_details and full-set retrieval via get_combinations, but there is no endpoint that accepts two codepoints and returns only their shared combination. You can fork this API on Parse and revise it to add a filtered endpoint accepting left_codepoint and right_codepoint as query parameters.What format should the `codepoint` parameter use for `get_emoji_details`?+
'1f600'. Emojis composed of multiple Unicode codepoints use dash-separated values, for example '1f1e6-1f1fa'. The codepoint field on any emoji object returned by get_combinations or search_emojis is already in the correct format to pass directly to get_emoji_details.