API Concepts
Core concepts and technical details for understanding and working with the Trading Card API.
Available Concepts​
Data Structure​
- Set Types - Understanding base, parallel, variation, insert, and other set types
- JSON:API Format - Understanding our JSON:API implementation
- Resource Relationships - How resources connect to each other
- Data Models - Complete data structure reference
Query Features​
- Querying Conventions - Which parameters each resource accepts, the
like:partial-match prefix, root-only set listings, and why an unknown parameter is silently ignored - Filtering and Sorting - Advanced filtering and search capabilities
- Pagination - Efficient data retrieval patterns
- API Reference - Complete endpoint documentation with examples
Image Management​
- Working with Images - Upload, manage, and download card images
- Responsive Card Images - Implement responsive images with thumbnails and size variants
- CDN Integration - Leverage global CDN delivery with versioned URLs for optimal performance
Data Quality and Attribution​
Understanding where your trading card data comes from is essential for building trustworthy applications. The Set Sources API enables you to track the origin of your data, verify its accuracy, and provide proper attribution to data sources.
- Data Provenance and Set Sources - Learn how to track data origins for checklists, metadata, and images. Understand why data attribution matters, when to verify sources, and best practices for maintaining data quality in your application.
API Behavior​
- Rate Limiting - Usage limits and throttling
- Error Handling - Error codes and troubleshooting
- Authentication - OAuth 2.0 and token management
Advanced Topics​
- Webhooks - Real-time notifications (Coming Soon)
- Bulk Operations - Efficient batch processing (Coming Soon)
- Search - Full-text search capabilities (Coming Soon)
Getting Started​
For practical examples of these concepts in action, visit our Code Examples section or start with the Getting Started guide.