CARDEYEQ FOR SHOPS

Your inventory. More discoverable.

Connect your product feed to your public CardEyeQ shop page. Start with a free listing, verify ownership and generate a key for each location.

Open shop owner center →Get setup help

01 · CLAIM

Find your shop.

Open your listing and request ownership. We verify your role through an independent business contact.

02 · CONNECT

Create an API key.

Your inventory key belongs to one shop location. Generate and revoke keys in the owner center.

03 · SHARE

Send product updates.

Share sealed products, singles and accessories from your own system. Updates are labelled as shop-provided inventory.

Inventory API · v1

POST https://www.cardeyeq.com/api/v1/shop-inventory

Send JSON with Authorization: Bearer YOUR_SHOP_KEY and a unique Idempotency-Key for each batch. Repeat the same key and payload to safely retry a request.

{
  "items": [{
    "externalId": "pokemon-booster-box-001",
    "name": "Pokémon booster display",
    "kind": "sealed",
    "game": "pokemon",
    "setName": "Your exact expansion name",
    "barcode": "Your UPC",
    "priceCents": 14999,
    "currency": "USD",
    "quantity": 6,
    "productUrl": "https://yourshop.com/products/booster-display"
  }]
}

For singles, use kind: "single" and include setName, cardNumber, condition and variant to describe the exact printing. Accessories use kind: "accessory".

Game values: pokemon, magic, one_piece, lorcana, yugioh, flesh_and_blood, riftbound, gundam, sports, other_tcg

Update rules: Send 1–100 items per batch, up to 120 requests per hour per shop. Batches patch the items they contain; omitted items keep their previous expiration. Send quantity: 0 to remove an item from availability. Reports expire 24 hours after observedAt; resend fresh stock at least daily. If you omit observedAt, we use the receive time. Older reports never replace newer ones.

Use integer cents and whole-unit quantities. The first version supports USD. Product links must use the shop website domain recorded on your listing. Keys stay on your server; there is no browser-side API access or automatic POS integration in this first version.

// Successful response
{ "accepted": 1, "replayed": false }

// Errors: 400 invalid item; 401 invalid/revoked key;
// 409 idempotency conflict; 413 payload too large;
// 429 rate limit (respect Retry-After); 503 retry later.

Partnership opportunities

Ask about staff app access, shop event promotion and the paid referral pilot. Directory listing and API access do not automatically enroll your business in a commission program.

Talk about a partnership →

Inventory API · v1

POST https://www.cardeyeq.com/api/v1/shop-inventory

Send JSON with Authorization: Bearer YOUR_SHOP_KEY and a unique Idempotency-Key for each batch. Repeat the same key and payload to safely retry a request.

{ "items": [{ "externalId": "pokemon-booster-box-001", "name": "Pokémon booster display", "kind": "sealed", "game": "pokemon", "setName": "Your exact expansion name", "barcode": "Your UPC", "priceCents": 14999, "currency": "USD", "quantity": 6, "productUrl": "https://yourshop.com/products/booster-display" }] }

For singles, use kind: "single" and include setName, cardNumber, condition and variant to describe the exact printing. Accessories use kind: "accessory".

Game values: pokemon, magic, one_piece, lorcana, yugioh, flesh_and_blood, riftbound, gundam, sports, other_tcg

// Successful response { "accepted": 1, "replayed": false } // Errors: 400 invalid item; 401 invalid/revoked key; // 409 idempotency conflict; 413 payload too large; // 429 rate limit (respect Retry-After); 503 retry later.