{"data":{"@kind":"guide","slug":"mirror-the-catalog","title":"Check Cambridge TCG's paused bulk-catalog boundary","subtitle":"The route is public; catalog rows are not currently published.","intro":"The JSONL route returns publication-policy status only. It performs no catalog database read and emits no card rows because field-level lineage and a reviewed bulk-publication rule do not yet exist.","audiences":["mirror","aggregator","scraper"],"prerequisites":["curl or another HTTP client"],"estimated_minutes":3,"step_count":3,"steps":[{"step_number":1,"title":"Read the publication status","instruction":"One request returns exactly two JSONL records: a manifest and a footer. publication_status explains why count_expected and count_emitted are zero.","curl":"curl -H 'Accept-Encoding: gzip' \\\n  https://cambridgetcg.com/data/catalog.jsonl \\\n  > catalog.jsonl","expected_response_shape":"Line 1: { \"@kind\": \"catalog_manifest\", \"publication_status\": \"paused_pending_field_level_rights\", \"count_expected\": 0, ... }\nLine 2: { \"@kind\": \"catalog_footer\", \"publication_status\": \"paused_pending_field_level_rights\", \"count_emitted\": 0, \"complete\": false, \"catalog_complete\": false }","what_to_do_with_it":"Treat zero rows as an intentional publication boundary, not an empty catalog or a transient ingest outage."},{"step_number":2,"title":"Use a keyed lookup for a specific card","instruction":"Search by a concrete identifier, then request one universal-card document. Preserve the response's NOASSERTION and source tiers; do not walk keyed endpoints to recreate a bulk dump.","curl":"curl 'https://cambridgetcg.com/api/v1/search/cards?q=OP01-001'","what_to_do_with_it":"Choose a returned SKU and fetch /api/v1/universal/card/[sku] only for the user's requested card."},{"step_number":3,"title":"Wait for an explicit reopen","instruction":"Bulk rows reopen only after field-level lineage and an upstream-aware publication rule ship. A status change will appear in this route and the manifest; no date is promised.","what_to_do_with_it":"Use /api/v1/feedback to describe the exact fields and permitted purpose you need. That evidence can inform the future rights review."}],"gotchas":[{"title":"NOASSERTION is not publication permission","description":"A warning to downstream users cannot create Cambridge's own right to publish upstream bytes. That is why the route emits policy status instead of a NOASSERTION catalog."},{"title":"The response is still JSONL","description":"Parse the manifest and footer as two separate JSON objects, one per line.","symptom":"Your parser errors with 'JSON document has trailing content' or similar.","fix":"In Node: `body.split('\\n').filter(Boolean).map(JSON.parse)`. In Python: `[json.loads(line) for line in response.iter_lines() if line]`."},{"title":"Do not recreate the dump by enumeration","description":"Walking single-card endpoints to reconstruct the paused catalog would bypass the stated purpose and rate limits."}],"next_guide":{"slug":"track-one-card","title":"Inspect one card's public structural state","url":"/api/v1/guides/track-one-card","html_url":"/agents/guides/track-one-card"},"see_also":[{"label":"Universal representation spec","href":"/methodology/universal-representation"},{"label":"API contract","href":"/api/openapi.json"}],"last_verified":"2026-07-12","feedback":{"kind":"guide-feedback","endpoint":"/api/v1/feedback","body_template":{"kind":"guide-feedback","guide_slug":"mirror-the-catalog","step_number":"<which step had the issue, or null for whole-guide feedback>","observation":"<what you observed>","expected":"<what you expected>","reporter_contact":"<your email>"}},"html_sibling":"/agents/guides/mirror-the-catalog"},"_meta":{"spec_version":"1","endpoint":"/api/v1/guides/[slug]","retrieved_at":"2026-11-18T21:19:04.602Z","as_of":"2026-11-18T21:19:04.602Z","sources":["ctcg-derived"],"freshness_seconds":86400,"license":"CC0-1.0","request_id":"req_77c89a6d-e06","deprecation":null,"next_link":null,"self_reference":{"this_endpoint":"/api/v1/guides/[slug]","contains_self":true},"source_license":["cc0"]}}