{"id":21685888,"url":"https://github.com/sodascience/open_supply_hub","last_synced_at":"2026-04-29T16:31:30.351Z","repository":{"id":192791284,"uuid":"607894757","full_name":"sodascience/open_supply_hub","owner":"sodascience","description":"Processing supply chain data obtained from Open Supply Hub","archived":false,"fork":false,"pushed_at":"2023-08-30T18:13:24.000Z","size":16246,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-10-09T13:12:48.484Z","etag":null,"topics":["data","global-supply-chain","open-supply-hub","python"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sodascience.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2023-02-28T22:22:57.000Z","updated_at":"2025-02-13T20:21:21.000Z","dependencies_parsed_at":null,"dependency_job_id":"8acf2ff3-0963-44bd-a6e7-c80e8ab63d7f","html_url":"https://github.com/sodascience/open_supply_hub","commit_stats":null,"previous_names":["sodascience/open_supply_hub"],"tags_count":0,"template":false,"template_full_name":"UtrechtUniversity/re-python-package-setuptools","purl":"pkg:github/sodascience/open_supply_hub","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sodascience%2Fopen_supply_hub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sodascience%2Fopen_supply_hub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sodascience%2Fopen_supply_hub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sodascience%2Fopen_supply_hub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sodascience","download_url":"https://codeload.github.com/sodascience/open_supply_hub/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sodascience%2Fopen_supply_hub/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32434601,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T13:34:34.882Z","status":"ssl_error","status_checked_at":"2026-04-29T13:34:29.830Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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","global-supply-chain","open-supply-hub","python"],"created_at":"2024-11-25T16:23:33.866Z","updated_at":"2026-04-29T16:31:30.319Z","avatar_url":"https://github.com/sodascience.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Processing supply chain data obtained from Open Supply Hub\n\n### Introduction\n\nThis repository contains python scripts to download and process supply chain data from [Open Supply Hub](https://opensupplyhub.org). Open Supply Hub is a website that provides worldwide supply chain data for various industry sectors.\n\n**Input data**: The data can be obtained either as a JSON dump or via an API. Contact Open Supply Hub for pricing.\n\n**Output data**: Input data neatly formatted in CSV format. The data contains information about suppliers, the industry sectors they belong to, the brands they supply to, etc. \n\n\u003c!-- TABLE OF CONTENTS --\u003e\n### Prerequisites\n\nTo install and run this project, run the following command from your terminal:\n\n```\npip install -r requirements.txt\n```\n\n### Usage\n\nClone the repository, `cd` to it, and then follow either the JSON dump workflow or the API call workflow.\n\n#### JSON dump extraction\n\n1. Get a JSON dump from OpenSupplyHub (contact them for pricing), unzip it, and store it in the `data` folder.\n2. Add the user-supplied parameters in the `config_json.json` configuration file. \n3. Run `python open_supply_hub/process_json.py`\n4. The results should now appear as two files in the `results` folder\n\n#### API extraction\n\n1. Get API access / API key from OpenSupplyHub (contact them for pricing)\n2. Add the API key and other information in the `config_api.json` configuration file.\n3. Run `python open_supply_hub/process_api.py`\n4. The results should now appear as a single compressed file in the `results` folder\n\n### Output\n* Using the JSON dumps: Two CSV files, one with information about the facilities (name, address, etc), one with information about the contributions (date, supplier, etc)\n* Using the API: One CSV file in the same format as the Excel/CSV exports from the website.\n\n| os_id | contribution_date | name       | address           | country_code                                      | country_name | lat        | lng        | sector    | contributor (list) | number_of_workers                                 | … | is_closed | contributor_type                             |\n| ----- | ----------------- | ---------- | ----------------- | ------------------------------------------------- | ------------ | ---------- | ---------- | --------- | ------------------ | ------------------------------------------------- | - | --------- | -------------------------------------------- |\n| 0     | BD2020212VEDNJC   | 30/07/2020 | 2T's Creation     | Plot 1241 (3rd Floor), Begum Rokeya Sarani, Ea... | BD           | Bangladesh | 23.8006254 | 90.371022 | Apparel            | PPE: Mapped in Bangladesh (PPE: Mapped in Bang... | … | FALSE     | Academic / Researcher / Journalist / Student |\n| 1     | BD2020212VEDNJC   | 16/05/2022 |                   |                                                   |              |            |            |           | Apparel            | BRAC University (Mapped in Bangladesh: Export ... | … |           | Academic / Researcher / Journalist / Student |\n| 2     | BD2020212VEDNJC   | 16/05/2022 |                   |                                                   |              |            |            |           | Apparel            | An Academic / Researcher / Journalist / Studen... | … |           | Academic / Researcher / Journalist / Student |\n| 3     | BD2020212VEDNJC   | 29/11/2021 |                   |                                                   |              |            |            |           | Apparel            | BRAC University (API)                             | … |           | Academic / Researcher / Journalist / Student |\n| 4     | BD2019248GNVQ6X   | 05/09/2019 | 3-A Fashions Ltd. | Madrasha Road, Khejur Bagan, Ashulia, Savar, D... | BD           | Bangladesh | 23.8909633 | 90.329906 | Apparel            | BRAC University (Mapped in Bangladesh: Export-... | … | FALSE     | Academic / Researcher / Journalist / Student |\n\n### License\n\nThe code in this project is released under [MIT License](/LICENSE).\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n### About the Project\n\n**Date**: February - April 2023\n\n**Researcher(s)**:\n\n- Luc Fransen (l.w.fransen@uva.nl)\n- Diliara Valeeva (d.valeeva@uva.nl)\n\n**Research Software Engineer(s)**:\n\n- Modhurita Mitra (m.mitra@uu.nl)\n- Javier Garcia Bernardo (j.garciabernardo@uu.nl)\n- Parisa Zahedi (p.zahedi@uu.nl)\n\n\u003c!-- CONTACT --\u003e\n## Contact\n\nThis project is developed and maintained by the [ODISSEI Social Data\nScience (SoDa)](https://odissei-data.nl/nl/soda/) team.\n\n\u003cimg src=\"https://odissei-soda.nl/images/logos/soda_logo.svg\" alt=\"SoDa logo\" width=\"250px\"/\u003e\n\nDo you have questions, suggestions, or remarks? File an issue in the issue tracker or feel free to contact the team via https://odissei-soda.nl/\n\nProject link: [https://github.com/sodascience/open_supply_hub](https://github.com/sodascience/open_supply_hub)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsodascience%2Fopen_supply_hub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsodascience%2Fopen_supply_hub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsodascience%2Fopen_supply_hub/lists"}