Skip to main content
POST
Search by Image
Beta — held until GA. Image search is live only for internal and design-partner keys: it requires the dedicated image-search:read scope and is gated off on the free/starter/public plans. This page previews the endpoint so partners can design against it; shapes may still change before general availability. It is not yet part of the public API surface.

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, an image_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

Request (URL-based):
Request (multipart upload): 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:

Want Early Access?

If image search is on your roadmap, email support@signa.so — we’d like to hear what you need so the first version covers the right workflows.