Lichcards documentation

AI assistants & API

Find trading cards, individual cards, accessories and board games using current product data. This guide helps developers and AI assistants search our shop and interpret its information correctly.

  • Public product data
  • Read without an API key
  • Shopify commerce

Get started

Search for a product first, then read the selected variant. Use the product page for specifications, contents, language and card condition.

Search products

GET /en/search/suggest.json?q=pokemon&resources%5Btype%5D=product&resources%5Blimit%5D=3

Read products and variants

GET /en/products/151-ultra-premium-collection-deck-box.js

Read your own session currency

GET /en/cart.js

The OpenAPI specification describes existing Shopify requests. Agent instructions and UCP discovery remain the source for current commerce capabilities.

Language, country and prices

Keep the same language and country settings across requests. An English URL does not automatically select delivery to the United Kingdom. Money values in the .js product API are in hundredths: 295 means 2.95 in the active currency. Search suggestions use decimal strings. Read the currency from your own /cart.js session. Shipping, any discounts and the final total are determined at checkout.

Access and capabilities

The three GET requests in this OpenAPI specification require no API key. They read public products and search results, or only your own cart session. They do not grant access to customer records, orders, payments or store administration. The specification includes no write operations.

Handle errors

Always check the HTTP status before parsing JSON. Invalid search parameters return a JSON error with status, message and description. An unknown product can return an empty 404 response: search again for the correct product. Back off on 429 and respect Retry-After when provided.

{
  "status": 422,
  "message": "Invalid parameter error",
  "description": "Type not supported."
}

Purchases through Shopify

Shopify publishes current capabilities through UCP. Read the discovery document first and follow its service, version and authentication requirements. For a purchase, use the selected variant and the buyer’s country and currency; payment requires the buyer’s approval.

UCP discovery