Emoji Kitchen 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.
What is the Emoji Kitchen 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.
curl -X GET 'https://api.parse.bot/scraper/88538791-a6a2-44cd-91a9-51d2b95c295e/get_combinations?limit=10' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace emojikitchen-dev-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Emoji Kitchen API — search emojis, explore combinations, fetch the full kitchen."""
from parse_apis.emoji_kitchen_api import EmojiKitchen, EmojiNotFound
client = EmojiKitchen()
# Search emojis by keyword — limit caps total items fetched
for emoji in client.emojis.search(query="heart", limit=5):
print(emoji.alt, emoji.emoji, emoji.category)
# Fetch a specific emoji by codepoint and explore its combinations
coffee = client.emojis.get(codepoint="2615")
print(coffee.alt, coffee.emoji, coffee.subcategory, coffee.keywords)
for combo in coffee.combinations.list(limit=3):
print(combo.alt, combo.left_emoji, combo.right_emoji, combo.is_latest)
# Typed error handling for a missing emoji
try:
client.emojis.get(codepoint="0000")
except EmojiNotFound as exc:
print(f"not found: {exc.codepoint}")
# Get the full kitchen overview with a limited set of combinations
kitchen = client.kitchens.get(limit=5)
print(kitchen.total_emojis, kitchen.total_combinations_found)
for e in kitchen.emojis[:3]:
print(e.codepoint, e.alt)
print("exercised: emojis.search / emojis.get / combinations.list / kitchens.get / EmojiNotFound")
Extract all emojis and their unique combinations. Returns metadata for 619 emojis and unique paired combinations extracted from Google's Emoji Kitchen data bundle. The combinations list contains deduplicated entries; use the limit parameter to control how many are returned. Each emoji includes its Unicode codepoint, display character, category, subcategory, and keyword tags.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of combinations to return. 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"
}
}About the Emoji Kitchen API
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.
The Emoji Kitchen API is a managed, monitored endpoint for emojikitchen.dev — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when emojikitchen.dev changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official emojikitchen.dev API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.