Question management

Fetch questions

GET
/questions

Query Parameters

lang?string

The language of the question/value

Default"en"
count?integer

The number of items to return

Default25
Range1 <= value
server_type?string

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

Default"off"
Value in"off" | "obf" | "opff" | "opf" | "off_pro"
insight_types?string

Comma-separated list, filter by insight types

countries?string

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

brands?string

Comma-separated list, filter by brands

value_tag?string

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

page?integer

Page index to return (starting at 1)

Default1
Range1 <= value
reserved_barcode?boolean

If true, also return questions about products with reserved barcodes

Defaultfalse
campaigns?string

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.

predictor?string

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

order_by?string

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
Default"popularity"
Value in"confidence" | "random" | "popularity"

Response Body

curl -X GET "https://robotoff.openfoodfacts.org/api/v1/questions?lang=en&count=25&server_type=off&insight_types=brand%2Clabel&countries=string&brands=carrefour%2Cferrero&value_tag=string&page=1&reserved_barcode=false&campaigns=agribalyse-category&predictor=universal-logo-detector&order_by=confidence"
{
  "status": "no_questions",
  "questions": [
    {}
  ],
  "count": 0
}