Readable URLs

Search by game and language

Variant rows include slug and catalogue_language. Normal and foil can share one readable slug while retaining distinct stable IDs.

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/{game}/{language}/cards

Request

  • Base URL: https://tcgdata-api.ottenniels1999.workers.dev
  • URL: https://tcgdata-api.ottenniels1999.workers.dev/v1/{game}/{language}/cards
  • Auth: HTTP bearer

Path parameters

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

pokemon, magic, lorcana, onepiece or yugioh. Japanese Pokémon uses pokemon/ja; pokemon_jp/ja is also supported.

languagestring required

Catalogue/artwork language from catalogue_language, not a price-market filter.

Query parameters

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. This route also always returns slug and catalogue_language. 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.

Comma-separated top-level fields; overrides view. id is always returned. Unknown or nested fields return 400. This route also always returns slug and catalogue_language.

Response

Success. 1 admitted HTTP request.

next_cursorstring nullable required

Changes

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