Resolve products by marketplace id

​

Maps Cardmarket or TCGplayer product ids to CardNexus products, up to 200 ids per call.

Each id resolves to at most one product, including the finish the id maps to — a marketplace product id is finish-specific, so a card's Foil and Standard printings carry different ids. Ids with no match come back with product: null, so a single call gives you a complete mapping table, misses included.

Pair this with the bulk import: resolve your Cardmarket idProduct (or TCGplayer product id) column to CardNexus product ids, then send those as the productId on each POST /v1/inventory/bulk/import row.

Authentication is required (any valid API key); no scope.

Body
required
application/json
  • ids
    Type: array integer[] 1…200
    min:  
    0
    max:  
    9007199254740991
    required

    The marketplace product ids to look up. 1–200 per call.

  • marketplace
    Type: string enum
    required

    Which marketplace your ids come from. cardmarket matches a Cardmarket product id (the idProduct in a Cardmarket stock file); tcgplayer matches a TCGplayer product id.

    values
    • cardmarket

      Cardmarket.

    • tcgplayer

      TCGplayer.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/products/resolve
curl https://public-api.cardnexus.com/v1/products/resolve \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "marketplace": "cardmarket",
  "ids": [
    0
  ]
}'

{
  "results": [
    {
      "externalId": 1234,
      "product": {
        "id": 50212,
        "name": "Black Lotus",
        "gameId": "mtg",
        "expansionId": 42,
        "finish": "Standard"
      }
    },
    {
      "externalId": 1235,
      "product": {
        "id": 50212,
        "name": "Black Lotus",
        "gameId": "mtg",
        "expansionId": 42,
        "finish": "Foil"
      }
    },
    {
      "externalId": 99999999,
      "product": null
    }
  ]
}

Resolution results returned, one per requested id.