{"id":15669942,"url":"https://github.com/alexgustafsson/systembolaget-api-data","last_synced_at":"2025-10-28T08:30:48.739Z","repository":{"id":83002419,"uuid":"111948624","full_name":"AlexGustafsson/systembolaget-api-data","owner":"AlexGustafsson","description":"An up to date data mirror of Systembolaget's APIs","archived":false,"fork":false,"pushed_at":"2024-05-02T09:48:36.000Z","size":21071,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-12-20T14:28:15.627Z","etag":null,"topics":["data","data-science","sweden","systembolaget"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlexGustafsson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-11-24T19:08:05.000Z","updated_at":"2024-12-10T19:51:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"7e35e188-3beb-4ec8-8fea-e6e6b549d437","html_url":"https://github.com/AlexGustafsson/systembolaget-api-data","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexGustafsson%2Fsystembolaget-api-data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexGustafsson%2Fsystembolaget-api-data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexGustafsson%2Fsystembolaget-api-data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexGustafsson%2Fsystembolaget-api-data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlexGustafsson","download_url":"https://codeload.github.com/AlexGustafsson/systembolaget-api-data/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238616406,"owners_count":19501844,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data","data-science","sweden","systembolaget"],"created_at":"2024-10-03T14:41:45.912Z","updated_at":"2025-10-28T08:30:42.702Z","avatar_url":"https://github.com/AlexGustafsson.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# systembolaget-api-data  - up to date git source of Systembolaget's assortment\n\nThe repository is automatically updated with changes by a bot running the\ncross-platform utility\n[systembolaget-api](https://github.com/AlexGustafsson/systembolaget-api).\n\n## Quickstart\n\n### Running the bot\n\nThe bot, available in `bot.sh`, is a simple shell script utilizing the\n[systembolaget-api](https://github.com/AlexGustafsson/systembolaget-api)\nutility.\n\nThe script features several commands, but they all add up to the `run` command,\nusable like so:\n\n```shell\n./bot.sh --repository https://github.com/user/repository --ssh-key \"$PWD/bot_ed25519\" run\n```\n\nThe SSH key can be generated using\n`ssh-keygen -o -a 100 -t ed25519 -f bot_ed25519` and should be added as a\n[Deploy Key](https://developer.github.com/v3/guides/managing-deploy-keys/) to\nthe repository. Make sure the key has `push` privileges.\n\nFor advanced usage, refer to the source code and the `help` command:\n\n```shell\n./bot.sh help\n```\n\nThe bot can also be run using Docker. First you'll need to build the image:\n\n```shell\ndocker build -t axgn/systembolaget-api-bot .\n```\n\nYou can then invoke it like so:\n\n```shell\ndocker run -it \\\n  --mount type=bind,source=\"$PWD/bot_ed25519,target=/etc/bot/bot_ed25519,readonly\" \\\n  --mount type=bind,source=\"$PWD/bot_ed25519.pub,target=/etc/bot/bot_ed25519.pub,readonly\" \\\n  axgn/systembolaget-api-bot run --ssh-key /etc/bot/bot_ed25519 --log debug\n```\n\nThe command for the container is identical to that of the `bot.sh` script. The\ndefault command is `run --log debug --ssh-key /etc/bot/bot_ed25519`.\n\nNote that the user `bot` within the container will have to have read access to\nthe mounted key files.\n\n## Table of contents\n\n[Quickstart](#quickstart)\u003cbr/\u003e\n[Examples](#examples)\u003cbr/\u003e\n[Use cases](#use-cases)\u003cbr/\u003e\n[Contributing](#contributing)\n\n## Examples\n\nExample of an assortment item from `data/assortment.json`:\n\n```json\n{\n  \"alcoholPercentage\": 4.5,\n  \"assortment\": \"FS\",\n  \"assortmentText\": \"Fast sortiment\",\n  \"bottleText\": \"Flaska\",\n  \"category\": null,\n  \"categoryLevel1\": \"Öl\",\n  \"categoryLevel2\": \"Ljus lager\",\n  \"categoryLevel3\": \"Pilsner - tysk stil\",\n  \"categoryLevel4\": null,\n  \"color\": \"Gul färg.\",\n  \"country\": \"Sverige\",\n  \"customCategoryTitle\": \"Öl, Ljus lager, Pilsner - tysk stil\",\n  \"dishPoints\": null,\n  \"ethicalLabel\": null,\n  \"grapes\": [],\n  \"images\": [\n    {\n      \"fileType\": null,\n      \"imageUrl\": \"https://product-cdn.systembolaget.se/productimages/831123/831123\",\n      \"size\": null\n    }\n  ],\n  \"isClimateSmartPackaging\": false,\n  \"isCompletelyOutOfStock\": false,\n  \"isDiscontinued\": false,\n  \"isEthical\": false,\n  \"isKosher\": false,\n  \"isManufacturingCountry\": true,\n  \"isNews\": false,\n  \"isOrganic\": true,\n  \"isRegionalRestricted\": false,\n  \"isSupplierTemporaryNotAvailable\": false,\n  \"isSustainableChoice\": false,\n  \"isTemporaryOutOfStock\": false,\n  \"isWebLaunch\": false,\n  \"originLevel1\": null,\n  \"originLevel2\": null,\n  \"otherSelections\": null,\n  \"packagingLevel1\": \"Flaska\",\n  \"price\": 15.9,\n  \"producerName\": \"Spendrups\",\n  \"productId\": \"831123\",\n  \"productLaunchDate\": \"2014-06-02T00:00:00\",\n  \"productNameBold\": \"Melleruds\",\n  \"productNameThin\": \"Utmärkta Pilsner\",\n  \"productNumber\": \"125303\",\n  \"productNumberShort\": \"1253\",\n  \"recycleFee\": 0,\n  \"restrictedParcelQuantity\": 0,\n  \"seal\": [],\n  \"sugarContent\": 0,\n  \"sugarContentGramPer100ml\": 0,\n  \"supplierName\": \"Spendrups Bryggeri AB\",\n  \"taste\": \"Maltig smak med inslag av knäckebröd, honung och citrusskal.\",\n  \"tasteClockBitter\": 6,\n  \"tasteClockBody\": 6,\n  \"tasteClockCasque\": 1,\n  \"tasteClockFruitacid\": 0,\n  \"tasteClockGroupBitter\": null,\n  \"tasteClockGroupSmokiness\": null,\n  \"tasteClockRoughness\": 0,\n  \"tasteClockSmokiness\": 0,\n  \"tasteClockSweetness\": 1,\n  \"tasteClocks\": [\n    {\n      \"key\": \"TasteClockBitter\",\n      \"value\": 6\n    },\n    {\n      \"key\": \"TasteClockBody\",\n      \"value\": 6\n    },\n    {\n      \"key\": \"TasteClockSweetness\",\n      \"value\": 1\n    }\n  ],\n  \"tasteSymbols\": [\"Fläsk\", \"Fisk\", \"Buffémat\", \"Sällskapsdryck\"],\n  \"usage\": \"Serveras vid 10-12°C som sällskapsdryck, till buffé eller till rätter av fisk eller ljust kött. \",\n  \"vintage\": null,\n  \"volume\": 330,\n  \"volumeText\": \"330 ml\"\n}\n```\n\nExample of a store item from `data/stores.json`:\n\n```json\n{\n  \"siteId\": \"0102\",\n  \"alias\": \"Fältöversten\",\n  \"address\": \"Karlaplan 13\",\n  \"postalCode\": \"115 20\",\n  \"city\": \"STOCKHOLM\",\n  \"phone\": \"08/662 22 89\",\n  \"county\": \"Stockholms län\",\n  \"Position\": {\n    \"latitude\": 59.3388103109104,\n    \"longitude\": 18.09087976878224\n  },\n  \"openingHours\": [\n    {\n      \"date\": \"2022-08-21T00:00:00\",\n      \"openFrom\": \"00:00:00\",\n      \"openTo\": \"00:00:00\",\n      \"reason\": \"-\"\n    },\n    {\n      \"date\": \"2022-08-22T00:00:00\",\n      \"openFrom\": \"10:00:00\",\n      \"openTo\": \"19:00:00\",\n      \"reason\": \"\"\n    },\n    {\n      \"date\": \"2022-08-23T00:00:00\",\n      \"openFrom\": \"10:00:00\",\n      \"openTo\": \"19:00:00\",\n      \"reason\": \"\"\n    },\n    {\n      \"date\": \"2022-08-24T00:00:00\",\n      \"openFrom\": \"10:00:00\",\n      \"openTo\": \"19:00:00\",\n      \"reason\": \"\"\n    },\n    {\n      \"date\": \"2022-08-25T00:00:00\",\n      \"openFrom\": \"10:00:00\",\n      \"openTo\": \"19:00:00\",\n      \"reason\": \"\"\n    },\n    {\n      \"date\": \"2022-08-26T00:00:00\",\n      \"openFrom\": \"10:00:00\",\n      \"openTo\": \"19:00:00\",\n      \"reason\": \"\"\n    },\n    {\n      \"date\": \"2022-08-27T00:00:00\",\n      \"openFrom\": \"10:00:00\",\n      \"openTo\": \"15:00:00\",\n      \"reason\": \"\"\n    },\n    {\n      \"date\": \"2022-08-28T00:00:00\",\n      \"openFrom\": \"00:00:00\",\n      \"openTo\": \"00:00:00\",\n      \"reason\": \"-\"\n    },\n    {\n      \"date\": \"2022-08-29T00:00:00\",\n      \"openFrom\": \"10:00:00\",\n      \"openTo\": \"19:00:00\",\n      \"reason\": \"\"\n    },\n    {\n      \"date\": \"2022-08-30T00:00:00\",\n      \"openFrom\": \"10:00:00\",\n      \"openTo\": \"19:00:00\",\n      \"reason\": \"\"\n    },\n    {\n      \"date\": \"2022-08-31T00:00:00\",\n      \"openFrom\": \"10:00:00\",\n      \"openTo\": \"19:00:00\",\n      \"reason\": \"\"\n    },\n    {\n      \"date\": \"2022-09-01T00:00:00\",\n      \"openFrom\": \"10:00:00\",\n      \"openTo\": \"19:00:00\",\n      \"reason\": \"\"\n    },\n    {\n      \"date\": \"2022-09-02T00:00:00\",\n      \"openFrom\": \"10:00:00\",\n      \"openTo\": \"19:00:00\",\n      \"reason\": \"\"\n    },\n    {\n      \"date\": \"2022-09-03T00:00:00\",\n      \"openFrom\": \"10:00:00\",\n      \"openTo\": \"15:00:00\",\n      \"reason\": \"\"\n    },\n    {\n      \"date\": \"2022-09-04T00:00:00\",\n      \"openFrom\": \"00:00:00\",\n      \"openTo\": \"00:00:00\",\n      \"reason\": \"-\"\n    },\n    {\n      \"date\": \"2022-09-05T00:00:00\",\n      \"openFrom\": \"10:00:00\",\n      \"openTo\": \"19:00:00\",\n      \"reason\": \"\"\n    }\n  ]\n}\n```\n\n## Use cases\n\nThe utility can be used to automatically grab the latest available data from\nSystembolaget. The data can be used to create interesting statistical charts,\narchives and more. Note however that data derived from the platform should not\nbe used in a way that goes against\n[Systembolaget's mission](https://www.omsystembolaget.se/english/systembolaget-explained/).\n\n## Contributing\n\nAny help with the project is more than welcome. Although this is largely a\nmirror of Systembolaget's data, any corrections to it or the bot is welcome.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexgustafsson%2Fsystembolaget-api-data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexgustafsson%2Fsystembolaget-api-data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexgustafsson%2Fsystembolaget-api-data/lists"}