API Documentation >> API 2.0 Main >> Marketplace Information >> User Articles

User Articles

Allowed HTTP Methods

• GET - Returns the available articles for a specified user. The response can be paginated by using the start and maxResults parameters.

Attention: The number of returned articles for a set of filter parameters is limited to 1000, no matter if paginated or unpaginated.

Resource Information

• Authentication - Only required for App
• Response Format - XML or JSON
• Response Object - Article
• API Version - 2.0
• Resource URI - https://api.cardmarket.com/ws/v2.0/users/:idUser/articles

Parameters

• idUser
  • User ID or Username
  • Type: integer (ID) or string (name)
  • Mandatory
• idGame
  • Game ID (query parameter)
  • Type: integer
  • Optional (if not provided, 1 for Magic is default)
• start and maxResults (query parameter)
  • Type: integer and integer
  • Optional (if not provided, start = 0 and maxResults = 1000)
  • maxResults must not be greater than 1000
  • See also: Partial Content Documentation
• idLanguage
  • Type: integer
  • Optional (if not provided or invalid, results from all languages are returned)
• minCondition
  • Type: string ( "MT" | "NM" | "EX" | "GD" | "LP" | "PL" | "PO")
  • Optional (if not provided or invalid, no condition filter is applied)
  • If provided, articles with the specific condition or better are returned.
  • If provided, only singles are returned.
• rarity
  • Type: string
  • Optional (if not provided or invalid, all rarities are returned)
• isFoil
  • Type: string ("true"|"false")
  • Optional
• isSigned
  • Type: string ("true"|"false")
  • Optional
• isAltered
  • Type: string ("true"|"false")
  • Optional
• isReverseHolo
  • Type: string ("true"|"false")
  • Optional
• isPlayset (DEPRECATED) - As of 11.11.2024 this query parameter is no longer supported.
  • Type: string ("true"|"false")
  • Optional
• isFirstEd
  • Type: string ("true"|"false")
  • Optional
• isFullArt
  • Type: string ("true"|"false")
  • Optional
• isUberRare
  • Type: string ("true"|"false")
  • Optional
• isWithDie
  • Type: string ("true"|"false")
  • Optional
• isInPackage
  • Type: string ("true"|"false")
  • Optional
• expansionName
  • Type: string
  • Optional (if not provided or invalid, results from all expansions are included)
• idWantslist
  • Type: integer
  • Optional (if provided, results that are in this wantslist are returned)
• name
  • Type: string
  • Optional (if provided, results that include the provided string in their name will be returned)
• minPrice
  • Type: float
  • Optional (if not provided, no minimum price filter is used)
• maxPrice
  • Type: float
  • Optional (if not provided, no maximum price filter is used)
• comments
  • Type: string
  • Optional (if provided, results that include the provided string in their comments will be returned )
• minAvailable
  • Type: integer
  • Optional (if provided, results with quantity equal or qreater than minAvailable will be returned)
• sort
  • Type: string ("name_asc" | "name_desc" | "price_asc" | "price_desc")
  • Optional (if provided sorting is applied )
    • name_asc Filter by name (A to Z)
    • name_desc Filter by name (Z to A)
    • price_asc Filter by price (cheapest first)
    • price_desc Filter by price (most expensive first)

Example Request

• Return 100 first articles

https://api.cardmarket.com/ws/v2.0/users/karmacrow/articles?start=0&maxResults=100

• Sort by name (A to Z)

https://api.cardmarket.com/ws/v2.0/users/karmacrow/articles?sort=name_asc

• Return articles from an expansion

https://api.cardmarket.com/ws/v2.0/users/karmacrow/articles?expansionName=Aether%20Revolt

• Return articles from a specific rarity

https://api.cardmarket.com/ws/v2.0/users/karmacrow/articles?rarity=Mythic

• Return articles of the specified condition or better

https://api.cardmarket.com/ws/v2.0/users/karmacrow/articles?minCondition=EX