Search by Image
Search
Search by Image
Find visually similar trademarks by logo/image similarity (beta — not yet generally available)
POST
Search by Image
Overview
Upload a logo or image and get back trademarks whose figurative marks look similar — useful for clearance searches, logo lookalikes, and design-mark screening. Works alongside text search (Search Trademarks) and autocomplete (Suggest). The endpoint accepts a multipart image upload, animage_url (https, SSRF-guarded),
or a media_id (reuse an existing mark’s stored logo), and returns a ranked,
mark-level list. Each hit carries a named signals explanation block (visual,
logo_text, exact_dup, vienna_overlap) and a thumbnail URL. Results are a bounded
top-K (limit ≤ 100, no deep pagination); the query image is never stored.
Shape
multipart/form-data with an image file part
(≤ 8 MB, raster only — no SVG) and optional filters / crop / channels /
limit fields (the structured ones JSON-encoded).
Request (existing logo): { "media_id": "med_..." } reuses that media’s
stored vector — no re-embedding.
Response: