---
title: "Search for logos"
method: GET
path: "/images/logos/search"
tags: ["Logo Management"]
---

# Search for logos

`GET /images/logos/search`

Search for logos detected using the universal-logo-detector model that
meet some criteria (annotation status, annotated, type,...)

## Query parameters

- `server_type` 'off' | 'obf' | 'opff' | 'opf' | 'off_pro'
- `barcode` string
- `count` number
- `type` string
- `value` string
- `taxonomy_value` string
- `min_confidence` number
- `random` boolean
- `annotated` boolean, nullable

## Response `200`

The search results

- object
  - `logos` LogoDetails[], required — Found logos
    - `annotation_type` string — The type of the logo annotation (ex: "brand", "label",...)
    - `annotation_value` string — The value of the logo annotation.
    - `annotation_value_tag` string — The value tag of the logo annotation.
    - `barcode` string, required — Barcode of the product the logo annotation is about.
    - `bounding_box` number[] — The bounding box of the logo as a list of ratio coordinates.
    - `completed_at` string, date-time — The datetime of completion of the annotation, in ISO format.
    - `id` integer, required — The ID of the logo annotation.
    - `image` object — Details about the image associated with the logo.
    - `nearest_neighbors` object — The nearest neighbor logos of this logo, as returned by the logo ANN search.
      - `distances` number[]
      - `logo_ids` number[]
    - `score` number — The confidence score of the annotation, between 0 and 1. The larger the score is the more confident we are in the annotation.
    - `server_type` ServerType — unresolved $ref
    - `source_image` string — The path of the image the logo was extracted from.
    - `taxonomy_value` string — The taxonomy tag associated to the logo, if any.
    - `text` string — The text detected on the logo.
    - `username` string — The username of the annotator who created the logo.
  - `count` number, required — Number of returned results

---

[API](https://skmtc.net/openfoodfacts/apis/api-reference.md) · [All operations](https://skmtc.net/openfoodfacts/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openfoodfacts/api-reference/revisions/23d26c6d55e6/schema)