{"uid":"cap_YY-D33ZJu8eK_CdiyhEDA","slug":"emoji-search-by-keyword-f5c80648","name":"Emoji Search by Keyword","description":"Find emoji by keyword or name, ranked from CLDR names, keywords and shortcodes, with group filter, capped at 50.","url":"https://emoji-tools.x402tookit.com/emoji-search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Words to search: 'grinning cat', 'rocket', 'thumbs up'"},"group":{"type":"string","description":"Optional group such as Animals & Nature (see /emoji-group)"},"limit":{"type":"integer","description":"Results 1 to 50 (default 10)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"group":{},"query":{"type":["null","string"]},"total":{"type":["null","number"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"]},"results":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":["null","string"]},"rank":{"type":["null","number"]},"emoji":{"type":["null","string"]},"group":{"type":["null","string"]},"score":{"type":["null","number"]},"status":{"type":["null","string"]},"subgroup":{"type":["null","string"]},"codepoints":{"type":["array","null"],"items":{"type":"string"}},"shortcodes":{"type":["array","null"],"items":{"type":"string"}},"emojiVersion":{"type":["null","string"]}}}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"partialMatch":{"type":["boolean","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tosLAySC7dJ0bhNQ8bW9d","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for emoji by keyword or name, ranked by CLDR names, keywords, and shortcodes, with optional group filter and result cap of 50.","exampleAgentPrompt":"Find me emoji related to 'celebration' — show the top 5 results, filtered to the Activities group.","exampleUseCases":[{"title":"Emoji picker for chat app","prompt":"Search for emoji matching the word 'love' and give me the top 10 results so I can show them in my emoji picker."},{"title":"Nature emoji for a blog post","prompt":"Find me emoji related to 'tree' but only from the Animals & Nature group, up to 8 results."},{"title":"Rocket emoji lookup for social post","prompt":"What emoji match the keyword 'rocket'? Give me the top 3 with their shortcodes and codepoints."}],"resultDescription":"Returns a ranked list of up to 50 emoji matching the query, each with the emoji character, CLDR name, group, subgroup, shortcodes, Unicode codepoints, emoji version, qualification status, and a relevance score. Also includes metadata like total matches, query echo, source attribution, and whether the result is a partial match.","failureModes":["Missing required 'q' query parameter returns an error","Unrecognized group name may return empty results or be ignored","Limit exceeding 50 is capped at 50","Very obscure or misspelled keywords may return zero results","Network or payment failure returns no results"],"whenToPreferThis":"Use this endpoint when you need to discover emoji by natural language keyword, name, or concept and want results ranked by relevance across CLDR names, keywords, and shortcodes. Prefer this over hardcoded emoji lookups when the user provides a descriptive word rather than an exact emoji name or shortcode. It is ideal for building emoji pickers, enriching text with relevant emoji, or helping users find the right emoji for a concept.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:30:42.947Z","isFirstParty":false,"canonicalSlug":"emoji-search-by-keyword-f5c80648"}