Search cards

GET /api/v1/catalog/search?q=charizard%204&zone=intl&limit=25

Parameter	Required	Bounds
`q`	Yes	2–200 characters
`zone`	No	`intl`, `jp`, `chn`
`set`	No	Set code, at most 50 characters
`limit`	No	Integer 1–100, default 25

Matching

Every word must appear in the normalized search text, in any order. Text includes card names, set names/codes, printed numbers, languages and aliases. Terms of up to three characters match whole words: 4 does not match 104.

Results follow normalized printed-number order, not relevance. The response is { data: Card[] }, with no total or next-page cursor.

curl --fail-with-body --silent --show-error --get \
  'https://kardilo.com/api/v1/catalog/search' \
  -H "Authorization: Bearer ${KARDILO_ACCESS_TOKEN}" \
  --data-urlencode 'q=charizard 4' \
  --data-urlencode 'zone=intl' \
  --data-urlencode 'limit=25'

MCP uses search_cards with query and setCode instead of q and set, and returns { cards: Card[] }.

Matching​

Matching