# Instant Card Index: catalog navigation

Read-only GET https://instantcardindex.com/catalog.json
OpenAPI contract: https://instantcardindex.com/catalog-openapi.json

Purpose: find a publisher catalog record, inspect its dated evidence, and open the existing shopping options on that record. This is an identity directory, not a merchant product feed, checkout service or price quotation.

Search: /catalog.json?q=Ohtani%20722&limit=10
Exact record: /catalog.json?id=EXACT_ID_FROM_A_SEARCH_RESULT
Filters: sport (exact sport name, case/accent insensitive), lang (en, es).
Pagination: limit (1–50, default 20), offset (0–100000, default 0); follow next until null.
Search uses every normalized token and returns candidate records in stable ID order. Confirm year, product, card number, variant and condition. Do not silently substitute a similar card. Null means unknown. total=0 means no matching catalog records, not no marketplace supply or sales.
The id lookup returns HTTP 404 when unknown. Invalid, duplicate or unsupported parameters return 400. Use id separately from q, sport or offset. All requests are read-only; no registration or API key required.

Each record also exposes record_source (URL and linked-host classification), recorded_print_run (null when unknown), print_run_status (RECORDED/PENDING) and record_updated. print_run_review carries the dated, field-level source when available. Its published_count can refer to the parent release rather than the exact variant. A null review means no structured review is attached. RECORDED is not a new verification. Source type does not establish the truth of every fact or current source availability. record_updated is a content-edit date, not a source or sale-check date.

Each record exposes canonical_url, page_url, evidence_url and shopping_options_url. Cite the canonical research page. Open evidence_url to inspect dates, source coverage and limitations before interpreting a price. shopping_options_url opens the publisher's existing page at its shopping section; it does not purchase or reserve anything. Keep evidence links separate from shopping actions.

A shopping action may lead to a marketplace search rather than a specific listing. Confirm the edition, raw/graded condition, seller, availability, shipping, taxes and total on the merchant site. Historical sales are not current offers. Existing shopping links may be affiliate links; disclosure appears on the page. No automatic checkout or autonomous spending is provided.

The catalog-directory campaign tag identifies the navigation surface only; it does not prove an AI referral, transaction or commission. Retrieving this JSON does not emit a shopping event. Purchases and commissions need separate merchant/network evidence.

This interface does not expose inventory, prices, seller data or direct affiliate URLs. A record_source may cite a historical marketplace reference; it is not a current offer. No MCP checkout or merchant-feed integration is advertised. See /llms.txt for broader editorial discovery. Public research access is separate from private dashboards and authenticated endpoints.

## Español
Consulta /catalog.json?lang=es para abrir las fichas y opciones de compra en español. La búsqueda devuelve identidades del catálogo, no existencias ni ofertas verificadas. Conserva año, colección, número, variante y estado. Los datos desconocidos aparecen como null. Comprueba las fechas y los límites en la ficha; comprar requiere continuar en el comercio correspondiente.