v3

latestOpenAPI 3.0.0raw.githubusercontent.com2026-03-0936575.8 KB

Question Management

Fetch questions

Fetch questions based on various filters.

get/questions

Query parameters

langstring

The language of the question/value

countinteger

The number of items to return

server_type'off' | 'obf' | 'opff' | 'opf' | 'off_pro'

The server type (=project) to use, such as 'off' (Open Food Facts), 'obf' (Open Beauty Facts),...

insight_typesstring

Example:brand,label

Comma-separated list, filter by insight types

countriesstring

Comma separated list, filter by country value (2-letter code)

brandsstring

Example:carrefour,ferrero

Comma-separated list, filter by brands

value_tagstring

Filter by value tag, i.e the value that is going to be sent to Product Opener

pageinteger

Page index to return (starting at 1)

reserved_barcodeboolean

If true, also return questions about products with reserved barcodes

campaignsstring

Example:agribalyse-category

Filter by annotation campaigns (the insight must have all the campaigns) An annotation campaign allows to only retrieve questions or insights based on arbitrary criteria defined during insight import.

predictorstring

Example:universal-logo-detector

Filter by predictor value A predictor refers to the model/method that was used to generate the prediction.

order_by'confidence' | 'random' | 'popularity'

The field to use for ordering results:

confidence: order by (descending) model confidence, null confidence insights come last
popularity: order by (descending) popularity (=scan count)
random: use a random order

Response

The questions matching the filters

status'no_questions' | 'found'

countinteger

The total number of results with the provided filters