Catalogue

Browse stored card metadata

Stored variant identities, images and game-specific metadata across all six catalogues, even when current prices are missing or stale. Uses existing tcg_ variant IDs, without grouping different printings or claiming complete source-catalogue coverage.

1 admitted HTTP request. Unknown query/body parameters are rejected. Examples contain illustrative data and placeholder IDs; they are not live catalogue records.

get/v1/catalog/variants

Request

  • Base URL: https://tcgdata-api.ottenniels1999.workers.dev
  • URL: https://tcgdata-api.ottenniels1999.workers.dev/v1/catalog/variants
  • Auth: HTTP bearer

Query parameters

game'pokemon' | 'pokemon_jp' | 'magic' | 'lorcana' | 'onepiece' | 'yugioh'

pokemon, pokemon_jp, magic, lorcana, onepiece or yugioh.

qstring

Case-insensitive text match on the card name; no Lucene syntax.

setstring

Set ID from the catalogue.

limitinteger

Maximum results in one page.

afterstring

Use the returned next_cursor unchanged. Stop when next_cursor is null.

view'full' | 'compact'

Use compact for lists and recurring price syncs. Full includes card metadata.

selectstring

Comma-separated top-level fields; overrides view. id is always returned. Unknown or nested fields return 400. Also supports pricing, metadata_status, metadata_quality, metadata_text and finish_details. Allowed top-level fields: id, slug, catalogue_language, name, game, set_id, set_name, number, printed_number, finish, metadata, metadata_status, metadata_quality, metadata_text, finish_details, images, language, condition, pricing.

Comma-separated top-level fields; overrides view. id is always returned. Unknown or nested fields return 400. Also supports pricing, metadata_status, metadata_quality, metadata_text and finish_details.

Response

Success. 1 admitted HTTP request.

next_cursorstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.