{
  "aid": "thequestionmark.org:main-1.2.0",
  "name": "Questionmark API v1.2",
  "type": "Index",
  "description": "[Questionmark](http://www.thequestionmark.org/)\nstands for your right to know the story behind the products you buy: where they come from\nand how they are produced. We believe that this type of transparency is crucial to developing\nsustainable supply chains and healthy products. Our mission is to make consumers more aware of\nthe choices they have when buying a product and also to urge companies to become more transparent.\n\nThe Questionmark API allows access to this information by third parties. The more consumers\nsee this information, the more people will be able to make a sustainable and healthy choice,\nthe more producers have an incentive to become more sustainable and healthy.\n\n[Lees meer](http://www.thequestionmark.org/over) over, or\n[read more](http://www.thequestionmark.org/en/questionmark-organisation) about\nQuestionmark.\n\n### Terms and license\n\nAPI usage is free for non-commercial use, as long as you notify us and provide proper attribution\n([CC-BY-NC](https://creativecommons.org/licenses/by-nc/4.0/)). This applies to public endpoints and\nparameters documented here, requiring no authentication.\nIf you plan to make large amounts of queries (sustained >15 per minute),\nplease [contact](http://thequestionmark.org/contact) us first.\nFor commercial use, please contact [QM intelligence](http://www.qmintelligence.com/).\n\n### Beta status\n\nPlease note that this API has a long-running beta-status. Not all imaginable endpoints\nare present, and some parameters may be different than expected (because of historical reasons).\nWith a future 2.0 version of the API, we hope to clear this up.\n\nThis documentation is also not fully complete. Be careful when relying on undocumented features,\nas they may change without notice.\n\n### Technical notes\n\n* The base url for the API is `https://api-c.thequestionmark.org/api/v1.2`, so e.g. the product list\n  endpoint can be accessed at `https://api-c.thequestionmark.org/api/v1.2/products`.\n\n* Most endpoints return JSON by default, but to make sure you'll always receive JSON (also\n  in case of errors), you have to either add an `Accept: application/json` header to each request,\n  or append `.json` to the url (e.g. `/products.json` for the product list).\n\n### Concepts\n\n**Products** are (food) products from the supermarket (and elsewhere) as seen by consumers, each\nreceiving their own health score.\n\nThe _health score_ has a scale consisting of `C2`, `C1`, `B1`, `B2` and `A` (with `A` the best score),\nwhich correspond to _Least_, _Very poor_, _Poor_, _Fair_ and _Yes_ respectively. This score is\nawarded according to the product's health group. For historical reasons, this score is sometimes called\n_personal health score_.\n\n[Read more about the health scoring methodology](https://www.thequestionmark.org/en/about/health).\n\nThe _sustainability score_ and its subscores (_environment_, _social_ and _animals_) used to be a number\non a scale of 1 to 10. These scores have been removed in favour of a new way of sustainability ranking\nthat is currenty under development. For the purpose of backwards compatibility all products are considered\nto have a sustainability score of `null`. All related endpoints and parameters are **deprecated** and you are\nencouraged to stop using them.\n\n**Product alternatives** are similar products (currently based on usage, but that may change). Unless a specific\norder is requested by means of the `sort` parameter, \"recommended\" alternatives are ordered on top. Ties are\nbroken using a random factor, because no brand should be recommended over another based on an arbitrary property,\nsuch as its name. However, this randomness breaks pagination. Therefore the `page` parameter is ignored when the\ndefault order is applied (i.e. it is always considered to be \"1\").\n\n**Retailers** are most importantly supermarkets. We focus on 8 of about 50, being\n[Albert Heijn](http://www.ah.nl/), [Jumbo](http://www.jumbo.com/), [Plus](http://www.plus.nl/),\n[Coop](http://www.coop.nl/), [Lidl](http://www.lidl.nl/), [Aldi](http://www.aldi.nl/),\n[Marqt](http://www.marqt.nl/) and [EkoPlaza](http://www.ekoplaza.nl/), which together\ncover about 80% of the market.\n\n**Usages** are the main [taxonomy](https://en.wikipedia.org/wiki/Taxonomy_%28general%29) we\nuse to categorize products. Other categorizations, like the browsing categories on our\nwebsite or health groups, are derived from the usage.\nWhen a product belongs to a specific usage then the product implicitly belongs to all of that usage's\nancestors (in the hierarchy) as well.\n\n**Certificates** are certifications, like\n[EU Organic](http://ec.europa.eu/agriculture/organic/organic-farming/what-is-organic-farming/organic-certification_en),\n[Fairtrade](http://www.fairtrade.net/), [MSC](http://www.msc.org/) or [Vegan](https://www.vegansociety.com/), as found\non the package of the product.\n\n**Rankings** are publications from Questionmark about a product category. Each contains a list of products at\na certain point in time, ranked by sustainability and health issues. [See them here](https://www.thequestionmark.org/qm-wijzer/).",
  "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/thequestionmark.org/main/1.2.0/apis.json",
  "tags": [
    "thequestionmark.org",
    "main"
  ],
  "created": "2026-04-11",
  "modified": "2026-04-11",
  "specificationVersion": "0.19",
  "access": "3rd-Party",
  "maintainers": [
    {
      "FN": "Jentic",
      "X-github": "jentic",
      "url": "https://github.com/jentic"
    }
  ],
  "apis": [
    {
      "aid": "thequestionmark.org:main-1.2.0",
      "name": "Questionmark API v1.2",
      "description": "[Questionmark](http://www.thequestionmark.org/)\nstands for your right to know the story behind the products you buy: where they come from\nand how they are produced. We believe that this type of transparency is crucial to developing\nsustainable supply chains and healthy products. Our mission is to make consumers more aware of\nthe choices they have when buying a product and also to urge companies to become more transparent.\n\nThe Questionmark API allows access to this information by third parties. The more consumers\nsee this information, the more people will be able to make a sustainable and healthy choice,\nthe more producers have an incentive to become more sustainable and healthy.\n\n[Lees meer](http://www.thequestionmark.org/over) over, or\n[read more](http://www.thequestionmark.org/en/questionmark-organisation) about\nQuestionmark.\n\n### Terms and license\n\nAPI usage is free for non-commercial use, as long as you notify us and provide proper attribution\n([CC-BY-NC](https://creativecommons.org/licenses/by-nc/4.0/)). This applies to public endpoints and\nparameters documented here, requiring no authentication.\nIf you plan to make large amounts of queries (sustained >15 per minute),\nplease [contact](http://thequestionmark.org/contact) us first.\nFor commercial use, please contact [QM intelligence](http://www.qmintelligence.com/).\n\n### Beta status\n\nPlease note that this API has a long-running beta-status. Not all imaginable endpoints\nare present, and some parameters may be different than expected (because of historical reasons).\nWith a future 2.0 version of the API, we hope to clear this up.\n\nThis documentation is also not fully complete. Be careful when relying on undocumented features,\nas they may change without notice.\n\n### Technical notes\n\n* The base url for the API is `https://api-c.thequestionmark.org/api/v1.2`, so e.g. the product list\n  endpoint can be accessed at `https://api-c.thequestionmark.org/api/v1.2/products`.\n\n* Most endpoints return JSON by default, but to make sure you'll always receive JSON (also\n  in case of errors), you have to either add an `Accept: application/json` header to each request,\n  or append `.json` to the url (e.g. `/products.json` for the product list).\n\n### Concepts\n\n**Products** are (food) products from the supermarket (and elsewhere) as seen by consumers, each\nreceiving their own health score.\n\nThe _health score_ has a scale consisting of `C2`, `C1`, `B1`, `B2` and `A` (with `A` the best score),\nwhich correspond to _Least_, _Very poor_, _Poor_, _Fair_ and _Yes_ respectively. This score is\nawarded according to the product's health group. For historical reasons, this score is sometimes called\n_personal health score_.\n\n[Read more about the health scoring methodology](https://www.thequestionmark.org/en/about/health).\n\nThe _sustainability score_ and its subscores (_environment_, _social_ and _animals_) used to be a number\non a scale of 1 to 10. These scores have been removed in favour of a new way of sustainability ranking\nthat is currenty under development. For the purpose of backwards compatibility all products are considered\nto have a sustainability score of `null`. All related endpoints and parameters are **deprecated** and you are\nencouraged to stop using them.\n\n**Product alternatives** are similar products (currently based on usage, but that may change). Unless a specific\norder is requested by means of the `sort` parameter, \"recommended\" alternatives are ordered on top. Ties are\nbroken using a random factor, because no brand should be recommended over another based on an arbitrary property,\nsuch as its name. However, this randomness breaks pagination. Therefore the `page` parameter is ignored when the\ndefault order is applied (i.e. it is always considered to be \"1\").\n\n**Retailers** are most importantly supermarkets. We focus on 8 of about 50, being\n[Albert Heijn](http://www.ah.nl/), [Jumbo](http://www.jumbo.com/), [Plus](http://www.plus.nl/),\n[Coop](http://www.coop.nl/), [Lidl](http://www.lidl.nl/), [Aldi](http://www.aldi.nl/),\n[Marqt](http://www.marqt.nl/) and [EkoPlaza](http://www.ekoplaza.nl/), which together\ncover about 80% of the market.\n\n**Usages** are the main [taxonomy](https://en.wikipedia.org/wiki/Taxonomy_%28general%29) we\nuse to categorize products. Other categorizations, like the browsing categories on our\nwebsite or health groups, are derived from the usage.\nWhen a product belongs to a specific usage then the product implicitly belongs to all of that usage's\nancestors (in the hierarchy) as well.\n\n**Certificates** are certifications, like\n[EU Organic](http://ec.europa.eu/agriculture/organic/organic-farming/what-is-organic-farming/organic-certification_en),\n[Fairtrade](http://www.fairtrade.net/), [MSC](http://www.msc.org/) or [Vegan](https://www.vegansociety.com/), as found\non the package of the product.\n\n**Rankings** are publications from Questionmark about a product category. Each contains a list of products at\na certain point in time, ranked by sustainability and health issues. [See them here](https://www.thequestionmark.org/qm-wijzer/).",
      "image": "",
      "baseURL": "https://api-c.thequestionmark.org/api/v1.2",
      "humanURL": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/thequestionmark.org/main/1.2.0",
      "version": "1.2.0",
      "tags": [
        "thequestionmark.org",
        "main"
      ],
      "properties": [
        {
          "type": "OpenAPI",
          "name": "OpenAPI definition",
          "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/thequestionmark.org/main/1.2.0/openapi.json",
          "mediaType": "application/openapi+json"
        },
        {
          "type": "GitHubRepo",
          "url": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/thequestionmark.org/main/1.2.0"
        }
      ]
    }
  ]
}