Deprecation Notice 11/26/2018
Here at TCGplayer, we recognize that change allows us to improve. To keep improving, we will discontinue support of some older versions of our API in the near future. Removing these versions allows us to utilize resources where they are needed most to deliver the best possible API to you. In the future TCGplayer will be announcing our plans to sunset API versions via email and on docs.tcgplayer.com with as much prior notice as possible.
API deprecation will be conducted in two phases.
| Phase 1 | Phase 2 | |
|---|---|---|
| Impacted Versions | 1.4.0 1.5.0 1.6.0 1.7.0 1.7.1 1.8.0 1.11.0 | 1.3.0 1.8.1 1.9.0 1.9.1 1.10.0 1.13.0 /current/ |
| Recommended Version | 1.20.0 | 1.20.0 |
| Deprecation Date | November 26, 2018 | November 26, 2018 |
| Sunset Date | January 28, 2019 | April 29, 2019 |
- Version 1.20.0 is the latest version at the time of this document.
Note: Effective April 29, 2019, TCGplayer will require a version to be specified in your request. Requests with no version or the shortcut of /current/ will return a 404 response. This will protect integrations from breaking when new versions of the API are released.
Breaking Changes
For versions after v1.3.0, responses have changed from responses using CamelCase with the first letter of the first word capitalized to camelCase with the first word all lowercase.
| Endpoint | v1.13.0 Response | v1.20.0 Response |
|---|---|---|
| /catalog/categories | { "Success": true, "Errors": [], "Results": [ { "CategoryId": 55, "Name": "Architect TCG", "PublishDate": "11/19/2018", "LastModifiedDate": "2018-09-17T15:21:54" } ] } ** Response truncated for example. | { "totalItems": 57, "success": true, "errors": [], "results": [ { "categoryId": 55, "name": "Architect TCG", "modifiedOn": "2018-09-17T15:21:54.233", "displayName": "Architect TCG", "seoCategoryName": "Architect TCG", "sealedLabel": "Sealed Products", "nonSealedLabel": "Singles", "conditionGuideUrl": "https://store.tcgplayer.com/", "isScannable": true, "popularity": 0 } ] } |
Removed Endpoints
| Endpoint Removed | Suggested Replacement | Version no longer available in |
|---|---|---|
| GET /catalog/resourcepaths | GET /catalog/products/{productId}/media | v1.9.0 |
| GET /catalog/productconditions/{productId} | GET /catalog/products/{productId}/productconditions | v1.9.0 |
| GET /stores/{storeKey}/buylist/skus | GET /stores/{storeKey}/buylist/skuprices | v1.9.0 |
| GET /stores/{storeKey}/buylist/skus/{skuId} | GET /stores/{storeKey}/buylist/skuprices?skuId={skuId} | v1.9.0 |
| GET /pricing/liveprices | GET /stores/{storeKey}/inventory/skuprices | v1.9.0 |
| GET /inventory/market/{productConditionId} | GET /stores/{storeKey}/inventory/skus/{skuId} | v1.9.0 |
Additional Resources
Please review our Release Notes for additional information on changes between versions.
Please check Swagger for details on each endpoint. Swagger can be found for each version by replacing version with the :version you are looking for http://api.tcgplayer.com/:version/help/index. Example: http://api.tcgplayer.com/v1.17.0/help/index.
If you have comments or concerns, please reach out to us at [email protected] or through our TCGplayer Discord.
Thanks,
The TCGplayer API Team
Updated 9 months ago