---
title: "List insights"
method: GET
path: "/insights"
tags: ["Insight Management"]
---

# List insights

`GET /insights`

Return insights based on various filters. The results can be filtered by insight type, barcode, annotation status, and more.
The `insight_types` parameter is a comma-separated list of insight types to filter by.
If no `insight_types` are provided, insights of all types are returned.

## Query parameters

- `insight_types` string
- `barcode` integer
- `annotated` boolean
- `annotation` integer
- `value_tag` string
- `brands` string
- `countries` string
- `server_type` 'off' | 'obf' | 'opff' | 'opf' | 'off_pro'
- `predictor` string
- `order_by` 'random' | 'popularity'
- `count` integer
- `page` integer
- `campaigns` string
- `lc` string

## Response `200`

List of insights matching the criteria

- object
  - `insights` InsightSearchResult[]
    - `id` string, required — Insight ID
    - `type` string, required — Insight type
    - `barcode` integer, required — Barcode of the product
    - `countries` string[], required — country tags of the product
    - `data` object — a JSON object containing additional data about the insight.
      - `bounding_box` number[] — The bounding box of the logo as a list of ratio coordinates.
      - `logo_id` integer — the ID of the logo associated with the insight, if any
    - `source_image` string — the path of the image the insight was generated from.
    - `with_image` boolean — whether the insight has an associated image or not
  - `status` 'no_insights' | 'found'
  - `count` integer — The total number of results with the provided filters

---

[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/versions/23d26c6d55e6/schema)