{"openapi":"3.1.0","info":{"title":"S4/B Exchange API","version":"0.1.0","description":"Privacy-preserving discovery and, after validation, paid marketing decision tools from Search for Businesses, LLC.","contact":{"name":"S4/B Exchange","email":"search@for-businesses.com","url":"https://search.for-businesses.com/exchange"}},"servers":[{"url":"https://search.for-businesses.com"}],"paths":{"/api/exchange/v1/coverage":{"get":{"operationId":"describeCoverageCheck","summary":"Inspect the free coverage-check interface","responses":{"200":{"description":"Coverage-check documentation and allowed values","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"checkCoverage","summary":"Check whether S4/B can evaluate a proposed media-planning request","description":"Accepts only bounded planning categories. Do not send names, emails, personal information, raw prompts, creative, client records or media plans.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoverageRequest"},"examples":{"multilingualPublicService":{"summary":"Southern California multilingual public-service plan","value":{"sector":"public_service","geography":"southern_california","objective":"awareness","channels":["search","paid_social","video"],"language_plan":"multilingual","budget_band":"100000_499999","consumer_type":"ai_agent"}}}}}},"responses":{"200":{"description":"Coverage result with evidence and privacy metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoverageResponse"}}}},"400":{"description":"Invalid or unsupported request field"},"413":{"description":"Request body exceeds 8 KiB"},"415":{"description":"Content-Type is not application/json"}}},"options":{"operationId":"coverageCorsPreflight","summary":"CORS preflight","responses":{"204":{"description":"Preflight accepted"}}}},"/exchange/catalog.json":{"get":{"operationId":"getExchangeCatalog","summary":"Retrieve S4/B Exchange products, rights and protocol status","responses":{"200":{"description":"Machine-readable Exchange catalog","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"CoverageRequest":{"type":"object","additionalProperties":false,"required":["sector","geography","objective","channels","language_plan","budget_band"],"properties":{"sector":{"type":"string","enum":["public_service","health_human_services","local_commercial","entertainment_culture","other"]},"geography":{"type":"string","enum":["southern_california","california","united_states","other"]},"objective":{"type":"string","enum":["awareness","traffic","engagement","conversion","mixed"]},"channels":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","enum":["search","display","paid_social","video","ctv","programmatic_dooh"]}},"language_plan":{"type":"string","enum":["english_only","multilingual","undecided"]},"budget_band":{"type":"string","enum":["under_25000","25000_99999","100000_499999","500000_plus","undisclosed"]},"consumer_type":{"type":"string","enum":["human_ui","ai_agent","developer_test","undisclosed"],"default":"undisclosed"}}},"CoverageResponse":{"type":"object","required":["request","result","product","provenance","privacy"],"properties":{"request":{"$ref":"#/components/schemas/CoverageRequest"},"result":{"type":"object","required":["can_evaluate","benchmark_support","confidence","reasons","limitations","recommended_next_step"],"properties":{"can_evaluate":{"type":"boolean"},"benchmark_support":{"type":"string","enum":["benchmark_supported","partial_benchmark_support","structural_review_only"]},"confidence":{"type":"string","enum":["medium","low"]},"reasons":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}},"recommended_next_step":{"type":"string"}}},"product":{"type":"object"},"provenance":{"type":"object"},"privacy":{"type":"object"}}}}},"externalDocs":{"description":"S4/B Exchange human-readable foundation","url":"https://search.for-businesses.com/exchange"}}