API Documentation >> API 2.0 Main >> Marketplace Information
All Market Place request give you information about things from MKM's market place - games we support, products we list, articles available at the market, or user registered at MKM.
Resource | Allowed HTTP Methods | Ded | Wid | 3rd | Description |
---|---|---|---|---|---|
Games | GET | X | X | X | Returns the Games entities we support at MKM and you can sell and buy cards and products from. |
Expansions | GET | X | X | X | Returns Expansion entities for all expansions with single cards for a specific game. |
Expansion Singles | GET | X | X | X | Returns Product entities for all single cards in a specified expansion. |
Products | GET | X | X | X | Returns the Product entity for the product specified by its ID. |
Product List (File) | GET | X | X | X | Returns a gzipped CSV file with all relevant products available at Cardmarket. |
Price Guides (File) | GET | - | X | X | Returns a gzipped CSV file with price guides for the specified game.
Attention: This request is restricted to Widget apps, 3rd party apps, and Dedicated apps of powersellers and professionals |
Find Products | GET | X | X | X | Searches for a product and returns Product entities of the products found. Search parameters are provided as query parameters and can be a search string (search ) for a product's name; a flag, if only products should be returned that exactly match the given search string (exact ); a parameter indicating the game (idGame ); and a parameter indicating the language the search string is provided in (idLanguage ).
|
Articles | GET | X | X | X | Returns Article entities for available articles specified by their product ID. The resulting entities can be filtered by providing parameters as query parameters, including the state of the users (private, professional, powerseller); a minimum user score (outstanding, very good, etc.); the language a product is offered in; a minimum condition (for singles); a minimum amount for a single article offered; and flags indicating foil, signed, and altered singles.
Responses with more than 100 entities are temporarily redirected to a request URI specifying a maximum of 100 entities returned (see Temporary Redirect for more information). The maximum total count is 1.000 and no entites beyond that maximum is returned if requested. Additional (optional) query parameters serve as paginating filters, where you can set the number of articles returned as well as a starting parameter (see Partial Responses for more information). |
Metaproducts | GET | X | X | X | Returns the Metaproduct entity for the metaproduct specified by its ID. |
Find Metaproducts | GET | X | X | X | Searches for metaproducts and returns the Metaproduct entity of the metaproducts found. Search parameters are provided as query parameters and can be a search string (search ) for the metaproduct's name; a flag exact indicating if the search string must exactly match the metaproduct's name, a parameter indicating the game (idGame ); and a parameter indicating the language the search string is provided in (idLanguage ).
|
Users | GET | X | X | X | Returns the User entity for the user specified by its ID or exact name. |
Find Users | GET | X | X | X | Returns User entities for the users found. A search parameter (search ) must be specified for the user's name.
|
User Offers | GET | X | X | X | Returns Article entities for available articles from a specific user specified by its ID or name. The resulting entities can be filtered by providing parameters as query parameters, including the language a product is offered in; a minimum condition (for singles); a minimum amount for a single article offered; and flags indicating foil, signed, and altered singles.
For now start and maxResults parameters are mandatory. |
Export User Offers | GET | X | - | X | Returns details for a requested export of Article entities for available articles from a specific user specified by its ID. |
POST | X | - | X | Request the export of Article entities for available articles from a specific user specified by its ID. | |
List Requested Exports of User Offers | GET | X | - | X | Returns details for all requested exports of Article entities for available articles from a specific user specified by its ID. |