Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/junkwaxdata/cardlists
Sports Card set lists in easily consumable JSON Format
https://github.com/junkwaxdata/cardlists
baseball baseball-cards baseball-data bowman data dataset datasets donruss fleer json json-schema topps upper-deck
Last synced: about 14 hours ago
JSON representation
Sports Card set lists in easily consumable JSON Format
- Host: GitHub
- URL: https://github.com/junkwaxdata/cardlists
- Owner: JunkWaxData
- License: mit
- Created: 2025-01-11T15:40:13.000Z (9 days ago)
- Default Branch: main
- Last Pushed: 2025-01-19T14:00:38.000Z (1 day ago)
- Last Synced: 2025-01-19T15:18:14.260Z (1 day ago)
- Topics: baseball, baseball-cards, baseball-data, bowman, data, dataset, datasets, donruss, fleer, json, json-schema, topps, upper-deck
- Language: C#
- Homepage: https://www.junkwaxdata.com
- Size: 538 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Sports Cards JSON Repository
Welcome 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 and aims to expand to include football, hockey, and more. Developers, collectors, and enthusiasts alike can use this resource to power their projects, applications, or analyses.
## Why This Repository?
The Sports Cards JSON Repository addresses the gap in freely accessible, high-quality sports card datasets. By providing open data, we empower developers to:
- Create innovative tools for sports card collectors.
- Develop offline applications for managing and analyzing card collections.
- Use structured data for building machine learning models or generating insights.
Whether 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.
## Repository Structure
The repository is organized by sports and card sets. Each set is represented by a JSON file that adheres to our schema. Below is an example of the structure:
```json
{
"name": "Baseball Cards 1990",
"attributes": [
{
"attribute": "Rookie Card",
"note": "First appearance of player"
}
],
"sets": [
{
"name": "Factory Set",
"notes": ["Complete set included"],
"variations": [
{
"variation": "Reverse Back",
"note": "Reverse back facing right"
}
],
"parallels": [
{
"name": "Gold Edition",
"of": 1000,
"notes": ["Limited edition release"]
}
],
"cards": [
{
"number": "97",
"name": "Jose Canseco",
"attributes": ["RC"],
"note": "Star player",
"variations": [
{
"variation": "Error Card",
"note": "Misprint on back"
}
],
"parallels": [
{
"name": "Gold Edition",
"of": 1000,
"notes": ["Serial numbered"]
}
]
}
]
}
]
}
```
Key fields include:
- **name**: The card set name.
- **attributes**: General properties such as "Rookie Card."
- **sets**: Detailed information about specific card sets.
- **variations**: Differences within a set, such as error cards or unique backs.
- **parallels**: Limited edition versions with unique numbering or designs.
- **cards**: Individual cards with their attributes and notes.
## Language Examples
The `src` folder contains example code for loading and processing the JSON files:
| Language | Example File |
| -------------- | ----------------------- |
| **C#** | `src/csharp/Program.cs` |
| **Python** | `src/python/main.py` |
| **Go** | `src/go/main.go` |
| **TypeScript** | `src/ts/index.ts` |
These examples demonstrate how to parse JSON data and work with it effectively, making it easier to build applications or tools for collectors and developers.
## License
All 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.
## How to Contribute
We welcome contributions to expand and enhance this repository. To contribute:
1. Fork this repository.
2. Add or update a card set in JSON format.
3. Ensure your JSON complies with the `schema.json` file.
4. Submit a pull request with a description of your changes.
All pull requests are validated using ajv-cli to ensure JSON files meet schema requirements. Validation must pass for the request to be merged.
Guidelines for contributors:
- Use consistent formatting as shown in the examples.
- Double-check the accuracy of card data.
## Contact
For questions or suggestions, feel free to open an issue or reach out through GitHub.
By supporting this project, you’re contributing to a comprehensive resource for sports card data enthusiasts, developers, and collectors alike.