{"slug":"api-cardhedger-com-v1-agent-cards-card-search-5b03aa","title":"Search for cards with flexible filtering options","host":"api.cardhedger.com","method":"POST","resource":"https://api.cardhedger.com/v1/agent/cards/card-search","category":"search","description":"Search for cards with flexible filtering options.","price_listed":0.01,"price_asked":0.01,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":1681,"reported_calls_30d":7,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"category":"Baseball","page":1,"page_size":20,"search":"Shohei Ohtani"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"category":{"description":"Filter by category (e.g., 'Baseball', 'Basketball')","type":"string"},"number":{"description":"Filter by card number within the set (exact match, e.g. '150')","type":"string"},"page":{"default":1,"description":"Page number for pagination","minimum":1,"type":"integer"},"page_size":{"default":50,"description":"Number of results per page (1-100)","maximum":100,"minimum":1,"type":"integer"},"player":{"description":"Filter by player name","type":"string"},"raw_images_only":{"description":"Image preference. Omitted (default): return the raw card photo, falling back to the graded slab image only when no raw photo exists. true: force raw-only (no graded fallback). false: prefer the graded slab image.","type":"boolean"},"rookie":{"description":"Filter by rookie status (e.g., 'Rookie')","type":"string"},"search":{"description":"Search query for card name/description","type":"string"},"set":{"description":"Filter by set name (e.g., '2025 Topps Baseball')","type":"string"},"subset":{"description":"Filter by subset within the set (exact match, e.g. 'Base Set', 'Chrome')","type":"string"}},"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-19","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.01,"price_match":true,"latency_ms":1681,"error":null}],"description_full":"Search for cards with flexible filtering options.","last_updated":"2026-10-19T01:14:47.584Z","schemes":["exact"]}