Skip to main content
POST
/
v1
/
trademarks
/
image-search
Search by Image
curl --request POST \
  --url https://api.signa.so/v1/trademarks/image-search \
  --header 'Authorization: Bearer <token>'

Documentation Index

Fetch the complete documentation index at: https://docs.signa.so/llms.txt

Use this file to discover all available pages before exploring further.

Work in progress. Image search is under active development and is not yet available on the production API. This page previews the planned endpoint so you can design against it. Shapes and parameter names may change before GA.

​
Overview

Upload an image and get back trademarks that are visually similar — useful for clearance searches, logo lookalikes, and design-mark screening. Works alongside text search (Search Trademarks) and autocomplete (Suggest). The endpoint will accept either a URL to an image or a multipart upload, and return a ranked list of trademarks with visual-similarity scores.

​
Planned Shape

POST /v1/trademarks/image-search
Request (URL-based): 
{
  "image_url": "https://example.com/logo.png",
  "filters": {
    "offices": ["uspto", "euipo"],
    "nice_classes": [9, 42]
  },
  "limit": 20
}
Request (multipart upload): multipart/form-data with an image file part and an optional filters JSON part. Response: 
{
  "object": "list",
  "data": [
    {
      "id": "tm_abc123",
      "object": "trademark",
      "mark_text": "APPLE",
      "similarity_score": 0.94,
      "mark_feature_type": "figurative",
      "office_code": "uspto",
      "status": { "primary": "active", "stage": "registered" },
      "media": [
        { "url": "https://cdn.signa.so/.../logo.png", "type": "image" }
      ]
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "eyJ..." },
  "request_id": "req_xyz"
}

​
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.