{"openapi":"3.1.0","info":{"title":"FairScoreGuide Public API","version":"1.0.0","description":"Read-only product comparison and credit-education data for FICO 500–700 audiences.","contact":{"email":"support@fairscoreguide.com"}},"servers":[{"url":"https://www.fairscoreguide.com"}],"components":{"schemas":{"BrandMetrics":{"type":"object","properties":{"comparisonRoundups":{"type":"integer"},"learnGuides":{"type":"integer"},"scoreBands":{"type":"integer"}}},"ProductRow":{"type":"object","properties":{"name":{"type":"string"},"category":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"rating":{"type":"number"},"creditNeeded":{"type":"string"},"aprOrPremium":{"type":"string"},"bestFor":{"type":"string"},"reviewPath":{"type":"string","format":"uri"}}},"ProductList":{"type":"object","properties":{"publisher":{"type":"string"},"category":{"type":"string"},"count":{"type":"integer"},"brandMetrics":{"$ref":"#/components/schemas/BrandMetrics"},"products":{"type":"array","items":{"$ref":"#/components/schemas/ProductRow"}}}},"ProductDetail":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"issuer":{"type":"string"},"rating":{"type":"number"},"annualFee":{"type":"string"},"aprRange":{"type":"string"},"summary":{"type":"string"},"updatedAt":{"type":"string","format":"date"}}},"AuthorRef":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"}}},"GuideDetail":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"datePublished":{"type":"string"},"dateModified":{"type":"string"},"author":{"$ref":"#/components/schemas/AuthorRef"},"tldr":{"type":"string"},"citationBlocks":{"type":"array","items":{"type":"string"}}}},"ComparisonDetail":{"type":"object","properties":{"slug":{"type":"string"},"category":{"type":"string"},"title":{"type":"string"},"intro":{"type":"string"},"url":{"type":"string","format":"uri"},"updatedAt":{"type":"string","format":"date"},"citationBlocks":{"type":"array","items":{"type":"string"}},"faqs":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"answer":{"type":"string"}}}},"rows":{"type":"array","items":{"$ref":"#/components/schemas/ProductRow"}},"brandMetrics":{"$ref":"#/components/schemas/BrandMetrics"}}},"WizardBands":{"type":"object","properties":{"publisher":{"type":"string"},"wizardUrl":{"type":"string","format":"uri"},"bands":{"type":"array","items":{"type":"object"}},"comparisonCount":{"type":"integer"},"guideCount":{"type":"integer"},"brandMetrics":{"$ref":"#/components/schemas/BrandMetrics"}}}}},"paths":{"/api/v1/products":{"get":{"summary":"List comparison products","parameters":[{"name":"category","in":"query","schema":{"type":"string","enum":["credit-cards","loans","insurance"]}},{"name":"min_score","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Product list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductList"}}}}}}},"/api/v1/products/{slug}":{"get":{"summary":"Get credit card review by slug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDetail"}}}},"404":{"description":"Not found"}}}},"/api/v1/guides/{slug}":{"get":{"summary":"Get guide metadata by slug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Guide metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuideDetail"}}}},"404":{"description":"Not found"}}}},"/api/v1/comparisons/{category}/{slug}":{"get":{"summary":"Get comparison roundup by category and slug","parameters":[{"name":"category","in":"path","required":true,"schema":{"type":"string","enum":["credit-cards","loans","insurance"]}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Comparison roundup detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComparisonDetail"}}}},"404":{"description":"Not found"}}}},"/api/v1/wizard/bands":{"get":{"summary":"FICO band definitions for score wizard","responses":{"200":{"description":"Band list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WizardBands"}}}}}}}}}