Skip to main content
POST
/
v1
/
search
/
image
Image search
curl --request POST \
  --url https://api.signa.so/v1/search/image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form image='@example-file' \
  --form 'office=<string>' \
  --form threshold=0.75 \
  --form classes=123 \
  --form limit=50
{
  "results": [
    {
      "id": "tm_us_1234567",
      "office": {
        "code": "USPTO",
        "name": "United States Patent and Trademark Office",
        "country": "US",
        "region": "North America"
      },
      "mark": {
        "text": "APPLE",
        "transliteration": "<string>",
        "translation": "<string>",
        "type": "word",
        "disclaimer": "<string>"
      },
      "status": {
        "unified_status": "live_registered",
        "unified_status_code": "LR",
        "status_date": "2024-01-15",
        "office_status": "Registered",
        "office_status_code": "<string>",
        "substatus": "<string>",
        "reason": "<string>"
      },
      "canonical_id": "tm_canonical_apple_001",
      "office_data": {
        "registration_number": "1234567",
        "serial_number": "87654321",
        "application_number": "<string>",
        "publication_number": "<string>",
        "filing_reference": "<string>"
      },
      "classifications": {
        "nice_classes": [
          9,
          35,
          42
        ],
        "goods_services": "Computers; Retail services; Software design",
        "office_classes": [
          "<string>"
        ]
      },
      "owners": [
        {
          "name": "Apple Inc.",
          "type": "corporation",
          "country": "US",
          "address": {
            "street": "<string>",
            "city": "<string>",
            "state": "<string>",
            "postal_code": "<string>",
            "country": "<string>"
          },
          "role": "owner",
          "effective_date": "2023-12-25"
        }
      ],
      "dates": {
        "filing_date": "2020-03-15",
        "priority_date": "2023-12-25",
        "publication_date": "2023-12-25",
        "registration_date": "2023-12-25",
        "expiry_date": "2023-12-25",
        "renewal_date": "2023-12-25"
      },
      "coverage": {
        "countries": [
          "US"
        ],
        "territories": [
          "<string>"
        ],
        "madrid_protocol": true
      },
      "images": {
        "thumbnail": "<string>",
        "full": "<string>",
        "formats": [
          "<string>"
        ]
      },
      "related_registrations": {
        "count": 123,
        "canonical_id": "<string>",
        "same_mark_other_offices": [
          {
            "id": "<string>",
            "office": "<string>",
            "registration_number": "<string>",
            "status": "<string>",
            "filing_date": "2023-12-25",
            "url": "<string>"
          }
        ]
      },
      "metadata": {
        "data_quality_score": 50,
        "data_completeness": 50,
        "last_verified": "2023-11-07T05:31:56Z",
        "normalization_version": "<string>"
      },
      "similarity_score": 0.5,
      "urls": {
        "api": "<string>",
        "web": "<string>",
        "office_url": "<string>"
      }
    }
  ],
  "pagination": {
    "total_results": 123,
    "has_more": true,
    "next_cursor": "<string>"
  },
  "search_metadata": {
    "query": "<string>",
    "search_type": "<string>",
    "query_time_ms": 123,
    "offices_searched": [
      "<string>"
    ],
    "credits_used": 123
  }
}

Authorizations

Authorization
string
header
required

Use your API key from the dashboard. Include it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key at https://signa.so/dashboard

Body

image
file
required

Image file to search

office
string

Office code

threshold
number<float>
default:0.75
Required range: 0 <= x <= 1
classes
integer[]
limit
integer
default:50

Response

Similar images found

results
object[]
pagination
object
search_metadata
object