KLIQ|Developers

Catalog Registry

The catalog registry is the public library of known items — Pokémon cards, diamond cuts, luxury watches, building components, and more. Every item in the registry has a type, a category, and a linked grading schema.

Hierarchy

Vertical  (collector-scan)
└── Category  (trading-cards)
    └── Type  (pokemon-base-set)   ← links to a grading schema
        └── Item  (pkmn-base-charizard-holo-4)

When you create an inspection you reference an item (or a type for generic inspections). The linked grading schema tells the AI which attributes to grade.

Browsing the catalog

GET/v1/verticals/{slug}/catalog/categoriesList categories for a vertical
GET/v1/catalog/types/{typeSlug}/itemsList items in a type
GET/v1/catalog/items/searchSearch items by name
import { KliqClient } from '@kliq-ai/sdk';

const kliq = new KliqClient({ apiKey: process.env.KLIQ_API_KEY! });

// 1. List categories for the collector vertical
const categories = await kliq.catalog.categories.list('collector-scan');
// trading-cards | gemstones | watches | coins | wine

// 2. List types under a category
const types = await kliq.catalog.types.list('trading-cards');
// pokemon-base-set | pokemon-neo-genesis | mtg-alpha | mtg-beta | sports-baseball | ...

// 3. List items for a type
const items = await kliq.catalog.items.list('pokemon-base-set');
for (const item of items.data) {
  console.log(item.slug, '-', item.name);
}
// pkmn-base-charizard-holo-4   - Charizard Holo #4
// pkmn-base-blastoise-holo-2   - Blastoise Holo #2
// pkmn-base-venusaur-holo-15   - Venusaur Holo #15
// pkmn-base-pikachu-58         - Pikachu #58
// pkmn-base-mewtwo-holo-10     - Mewtwo Holo #10

Getting a single item

const charizard = await kliq.catalog.items.get('pkmn-base-charizard-holo-4');

console.log(charizard.name);       // "Charizard Holo #4"
console.log(charizard.attributes); // { setNumber: '4/102', rarity: 'Holo Rare', type: 'Fire' }
console.log(charizard.type.gradingSchemaSlug); // "psa-10-point"

Searching items

const results = await kliq.catalog.items.search({ search: 'charizard' });

for (const item of results.data) {
  console.log(`[${item.type.name}] ${item.name}`);
}
// [Pokémon Base Set] Charizard Holo #4

Grading guides

Grading guides provide human-readable descriptions and AI prompt hints for each possible grade value of an attribute. They are attached at the type level.

const guide = await kliq.catalog.types.gradingGuide('pokemon-base-set');

// guide.attributes['centering']['10'] →
// {
//   gradeValue: '10',
//   description: 'Perfect centering (50/50) in all four directions...',
//   promptHint: 'All four borders must be measurably equal...'
// }

Guides power AI grading

When you trigger AI grading, the platform injects the relevant grading guides as context into the vision model prompt. Better guides = better AI grades.

Adding private catalog items

Private items are only visible to your tenant. Use them for proprietary inventory or items not yet in the public registry.

const privateItem = await kliq.catalog.items.create('t_abc123', {
  typeSlug: 'pokemon-base-set',
  slug: 'pkmn-base-raichu-holo-14-1st-edition',
  name: 'Raichu Holo #14 (1st Edition)',
  description: 'Holographic Raichu from the first print run of Base Set.',
  attributes: {
    setNumber: '14/102',
    rarity: 'Holo Rare',
    type: 'Lightning',
    edition: '1st',
  },
});

console.log(privateItem.isPublic); // false

Next steps