API Documentation >> API 2.0 Main >> Marketplace Information >> Find Metaproducts

Find Metaproducts

Allowed HTTP Methods

• GET - Returns a metaproduct specified by a name to search for, a flag indicating if the metaproduct's name must exactly match the search string, the language ID the search term is given in and the game ID the metacard is searched for.
• It's also possible to send multiple search strings and it will return multiple metaproducts, see example below.

Resource Information

• Authentication - Only required for App
• Response Format - XML or JSON
• Response Object - Metaproduct
• API Version - 2.0
• Resource URI - https://api.cardmarket.com/ws/v2.0/metaproducts/find?

Parameters

• search (query parameter)
  • search string
  • Type: string | array
  • Mandatory
• exact (query parameter)
  • Indicates if the given search string must exactly match the metaproduct's name
  • Type: boolean (true|false)
  • Optional (if not provided, true is default)
• idGame (query parameter)
  • Game ID
  • Type: int
  • Optional (if not provided, 1 for Magic is default)
• idLanguage (query parameter)
  • Language ID the search string is provided in
  • Type: int
  • Optional (if not provided, 1 for English is default)
• maxResults (query parameter)
  • Returns the first X products instead of all
  • Type: int
  • Optional (if not provided, all products will be returned)
• onlyLatestProduct (query parameter)
  • Returns only the latest product
  • Type: boolean (true|false)
  • Optional (if not provided, false is default)

Example Request

1. Search for a metaproduct with the exact name "Tarmogoyf". As no game and language IDs are provided, the search term is provided in English and Magic is the game the metacard is searched for:

GET https://api.cardmarket.com/ws/v2.0/metaproducts/find?search=Tarmogoyf

2. Search for a metaproduct with "Schwarzes" in it's name, given in German and searched for Yugioh:

GET https://api.cardmarket.com/ws/v2.0/metaproducts/find?search=Schwarzes%20Loch&exact=false&idGame=3&idLanguage=3

3. Search for metaproducts with the exact name "Lightning Bolt" and "Spore Frog" and only return the latest product.

GET https://api.cardmarket.com/ws/v2.0/metaproducts/find?search=Lightning%20Bolt&search=Spore%20Frog&onlyLatestProduct=true