{"id":27648140,"url":"https://github.com/junkwaxhero/cardlists","last_synced_at":"2025-04-24T02:05:08.241Z","repository":{"id":272035919,"uuid":"915339536","full_name":"JunkWaxHero/CardLists","owner":"JunkWaxHero","description":"Sports Card set lists in easily consumable JSON Format for databases, apps, websites, and more!","archived":false,"fork":false,"pushed_at":"2025-04-19T12:02:41.000Z","size":13041,"stargazers_count":2,"open_issues_count":3,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-24T02:04:25.305Z","etag":null,"topics":["baseball","baseball-cards","baseball-data","bowman","data","dataset","datasets","donruss","fleer","json","json-schema","panini","topps","upper-deck"],"latest_commit_sha":null,"homepage":"https://www.junkwaxdata.com","language":"Python","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/JunkWaxHero.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"enusbaum"}},"created_at":"2025-01-11T15:40:13.000Z","updated_at":"2025-04-19T12:02:44.000Z","dependencies_parsed_at":"2025-01-29T02:26:16.776Z","dependency_job_id":"100b2605-5be4-459a-9034-9cb4fab75289","html_url":"https://github.com/JunkWaxHero/CardLists","commit_stats":null,"previous_names":["junkwaxdata/jsoncardlists","junkwaxdata/cardlists","junkwaxhero/cardlists"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JunkWaxHero%2FCardLists","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JunkWaxHero%2FCardLists/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JunkWaxHero%2FCardLists/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JunkWaxHero%2FCardLists/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JunkWaxHero","download_url":"https://codeload.github.com/JunkWaxHero/CardLists/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250546073,"owners_count":21448259,"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":["baseball","baseball-cards","baseball-data","bowman","data","dataset","datasets","donruss","fleer","json","json-schema","panini","topps","upper-deck"],"created_at":"2025-04-24T02:05:02.792Z","updated_at":"2025-04-24T02:05:08.228Z","avatar_url":"https://github.com/JunkWaxHero.png","language":"Python","funding_links":["https://github.com/sponsors/enusbaum"],"categories":[],"sub_categories":[],"readme":"# JunkWaxData - Sports Cards JSON Repository\n\n## Comprehensive Database for Collectors and Developers\n\n[![Baseball Cards Indexed](.github/badge/baseball.svg)](.github/badge/baseball.svg) [![Football Cards Indexed](.github/badge/football.svg)](.github/badge/football.svg) [![Basketball Cards Indexed](.github/badge/basketball.svg)](.github/badge/basketball.svg) [![Hockey Cards Indexed](.github/badge/hockey.svg)](badge/hockey.svg)\n[![Baseball Cards Indexed Graph](.github/graph/baseball_bar.png)](.github/graph/baseball_bar.png)\n\nWelcome to the Sports Cards JSON Repository, your ultimate destination for exploring sports card data in a structured and open-source format. This repository features comprehensive datasets for baseball cards, football cards, basketball cards, and hockey cards in a developer-friendly JSON format. Collectors, developers, and enthusiasts can use this resource to power their projects such as:\n\n* Integrating a complete sports card database into web applications\n* Building mobile apps with powerful search across MLB, NFL, NBA, and NHL card collections\n* Training machine learning models on structured sports memorabilia data\n* Managing personal card collections with accurate checklists\n\n## Why This Repository?\n\nThe Sports Cards JSON Repository addresses the gap in freely accessible, high-quality sports card datasets. By providing open data, we empower developers to:\n\n* Create innovative tools for sports card collectors\n* Develop offline applications for managing and analyzing card collections\n* Use structured data for building machine learning models or generating insights\n* Access comprehensive metadata about card sets across multiple sports\n\nWhether you're working on a trading card tracker, a sports card price guide, or exploring trends in sports memorabilia, this repository offers a solid foundation.\n\n## Repository Structure\n\nThe repository is organized by sports categories with releases organized by year:\n\n```text\nSports Cards JSON Repository\n├── categories/                    # Sport Categories\n│   ├── baseball.json              # Baseball Category metadata\n│   ├── football.json              # Football Category metadata \n│   ├── basketball.json            # Basketball Category metadata\n│   ├── hockey.json                # Hockey Category metadata\n|   ├── football/                  # Football Card Releases\n│   ├── basketball/                # Basketball Card Releases\n│   ├── hockey/                    # Hockey Card Releases\n│   └── baseball/                  # Baseball Card Release\n│       ├── 1990/                  # 1990 Baseball Releases\n│       │   ├── 1990-Topps.json    # 1990 Topps Baseball Release\n│       │   └── ...\n│       └── ...\n├── schemas/                       # JSON schemas for validation\n│   ├── category.json              # Schema for Category files\n│   └── release.json               # Schema for Card Releases\n├── scripts/                       # Python Utility Scripts\n└── examples/                      # Example code implementations\n    ├── csharp/                    # C# examples\n    ├── python/                    # Python examples\n    ├── go/                        # Go examples\n    ├── ts/                        # TypeScript examples\n    └── rust/                      # Rust examples\n```\n\n## Data Schema Structure\n\n### Category Files\n\nEach sport has a category file (e.g., `baseball.json`) defining available years and releases:\n\n```json\n{\n  \"$schema\": \"http://json-schema.org/draft-07/schema#\",\n  \"category\": {\n    \"name\": \"Baseball Cards\",\n    \"years\": [\n      {\n        \"year\": \"1990\",\n        \"releases\": [\n          {\n            \"name\": \"Topps Baseball\",\n            \"indexed\": true,\n            \"version\": \"1.0\",\n            \"uniqueId\": \"550e8400-e29b-41d4-a716-446655440000\"\n          },\n          {\n            \"name\": \"Upper Deck Baseball\",\n            \"indexed\": false\n          }\n        ]\n      },\n      {\n        \"year\": \"1991\",\n        \"releases\": [\n          {\n            \"name\": \"Donruss Baseball\",\n            \"indexed\": false\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\n### Card Release Files\n\nIndividual card set releases follow this structure:\n\n```json\n{\n  \"name\": \"Topps Baseball\",\n  \"version\": \"1.0\",\n  \"uniqueId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"attributes\": [\n    {\n      \"attribute\": \"RC\",\n      \"note\": \"Rookie Card\"\n    }\n  ],\n  \"sets\": [\n    {\n      \"name\": \"Factory Set\",\n      \"uniqueId\": \"ff789858-390c-4cb4-bbae-29bb501d91b3\",\n      \"notes\": [\"Complete set included\"],\n      \"numberedTo\": 1000,\n      \"parallels\": [\n        {\n          \"name\": \"Gold Edition\",\n          \"numberedTo\": 1000,\n          \"notes\": [\"Limited edition release\"]\n        }\n      ],\n      \"cards\": [\n        {\n          \"number\": \"97\",\n          \"uniqueId\": \"958bd99d-a01f-49d6-979f-154d7675142b\",\n          \"name\": \"Jose Canseco\",\n          \"attributes\": [\"RC\"],\n          \"note\": \"Star player\",\n          \"variations\": [\n            {\n              \"variation\": \"Error Card\",\n              \"note\": \"Misprint on back\"\n            }\n          ],\n          \"parallels\": [\n            {\n              \"name\": \"Gold Edition\",\n              \"numberedTo\": 1000,\n              \"notes\": [\"Serial numbered\"]\n            }\n          ]\n        }\n      ]\n    }\n  ]\n}\n```\n\n## Key Fields\n\n### Category Files\n\n* **name**: The sport category name (e.g., \"baseball\")\n* **years**: Array of year objects containing releases\n  * **year**: Year in YYYY or YYYY-YY format (e.g., \"1990\" or \"1990-91\")\n  * **releases**: Array of card releases for that year\n    * **name**: Release name\n    * **indexed**: Boolean indicating if this release is fully indexed\n    * **version**: (Optional) Version of the data\n    * **uniqueId**: (Optional) UUID for the release\n\n### Release Files\n\n* **name**: The name of the card list or set\n* **attributes**: General properties (e.g., \"Rookie Card\") with additional notes\n* **notes**: Optional notes providing extra context at the card list or set level\n* **sets**: Detailed information about specific card sets\n  * **numberedTo**: (Optional) The maximum number for cards in the set\n  * **insertOdds**: (Optional) An array of objects specifying insert odds\n  * **variations**: Differences within a set, such as misprints or unique designs\n  * **parallels**: Limited edition versions with unique numbering or designs\n* **cards**: Individual cards with their attributes, variations, and parallels\n\n## Code Examples\n\nThe `examples` folder contains example code for loading and processing the JSON files:\n\n| Language       | Example File            | Use Case |\n| -------------- | ----------------------- | -------- |\n| **C#**         | `examples/csharp/Program.cs` | .NET applications, desktop collectors' tools |\n| **Python**     | `examples/python/main.py`    | Data analysis, web scrapers for card data |\n| **Go**         | `examples/go/main.go`        | High-performance card search APIs |\n| **TypeScript** | `examples/ts/index.ts`       | Web-based card collection managers |\n| **Rust**       | `examples/rust/main.rs`      | Performance-critical card data processing |\n\nThese examples demonstrate how to parse JSON data and work with it effectively, making it easier to build applications or tools for collectors and developers.\n\n## License\n\nAll JSON files in this repository are licensed under the MIT License. This ensures you can freely use, modify, and distribute the data while retaining proper attribution.\n\n## How to Contribute\n\nWe welcome contributions to expand and enhance this repository. \n\nTo contribute:\n\n1. Read our handy [HOWTO](HOWTO.md) on creating your own JSON Releases\n2. Fork this repository\n3. Add or update a card set in JSON format\n4. Ensure your JSON complies with the provided JSON schemas\n5. Submit a pull request with a description of your changes\n\nAll pull requests are validated against our JSON schemas to ensure data consistency. Validation must pass for the request to be merged.\n\nGuidelines for contributors:\n\n* Use consistent formatting as shown in the examples\n* Double-check the accuracy of card data\n* Include complete set information where possible\n* Add appropriate metadata to help with searchability\n\n## Contact\n\nFor questions or suggestions about our sports card database, feel free to open an issue or reach out through GitHub.\n\nBy supporting this project, you're contributing to a comprehensive resource for sports card data enthusiasts, developers, and collectors alike.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjunkwaxhero%2Fcardlists","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjunkwaxhero%2Fcardlists","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjunkwaxhero%2Fcardlists/lists"}