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

Find Products

Allowed HTTP Methods

• GET - Searches for products by a given search string

Resource Information

• Authentication - Only required for App
• Response Format - XML or JSON
• Response Object - Product (without details!)
• API Version - 2.0
• Resource URI - https://api.cardmarket.com/ws/v2.0/products/find

Parameters

• search (query parameter)
  • search string
  • Type: string
  • Mandatory
• exact (query parameter)
  • indicates if only products should be returned where the name exactly matches the search string
  • Type: boolean (true|false)
  • Optional
• 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
• start and maxResults (query parameter)
  • If specified, only maxResults entities are returned starting from start
  • Type: integer and integer
  • Optional (if provided, both must be provided)
  • See also: Partial Content Documentation

Example Request

1. Search for Magic products with "Springleaf" in their English name (will return "Springleaf Drum" from Born of the Gods and Lorwyn):

GET https://api.cardmarket.com/ws/v2.0/products/find?search=Springleaf&idGame=1&idLanguage=1

2. Search for Magic products with the exact English name "Springleaf Drum" (will return "Springleaf Drum" from Born of the Gods and Lorwyn):

GET https://api.cardmarket.com/ws/v2.0/products/find?search=Springleaf%20Drum&exact=true&idGame=1&idLanguage=1