{ "openapi": "3.1.0", "info": { "title": "SafePulse API", "description": "SafePulse \u2014 product safety intelligence: CPSC, FDA, USDA FSIS, NHTSA recalls; EU RAPEX; home safety scores; child/vehicle safety ratings; food safety alerts worldwide.", "version": "1.2.0", "contact": { "url": "https://safepulse.vercel.app" }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Follow up with /clearcarepulse for healthcare cost estimates if injuries occur; /tradepulse for import compliance on recalled foreign goods; /nutripulse for food safety context." }, "servers": [ { "url": "https://safepulse.vercel.app" } ], "paths": { "/api/safe/recall": { "get": { "summary": "Active recall dashboard", "description": "Consolidated active recalls across CPSC, FDA, USDA FSIS, and NHTSA with specific consumer actions", "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "all", "food", "drug", "vehicle", "product" ] }, "description": "Filter by recall category" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Active recall digest" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.08, "x-agent-use-case": "on-demand" } }, "/api/safe/product": { "get": { "summary": "Consumer product safety", "description": "CPSC SaferProducts.gov incident data for any consumer product \u2014 hazard patterns, recall history, safer alternatives", "parameters": [ { "name": "product", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string" }, "description": "toys | furniture | appliances | electronics | clothing" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Product safety report" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.1, "x-agent-use-case": "on-demand" } }, "/api/safe/vehicle": { "get": { "summary": "Vehicle safety", "description": "NHTSA crash ratings, recall history, and owner complaint analysis for any make/model/year", "parameters": [ { "name": "make", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "model", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "year", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Vehicle safety report" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.1, "x-agent-use-case": "on-demand" } }, "/api/safe/food": { "get": { "summary": "Food and drug recall", "description": "FDA food/drug enforcement records and USDA FSIS recalls \u2014 contamination risk, allergen flags, Class I/II/III classification", "parameters": [ { "name": "product", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "food", "drug", "supplement", "all" ] } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Food/drug safety report" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.08, "x-agent-use-case": "on-demand" } }, "/api/safe/home": { "get": { "summary": "Home safety hazards", "description": "CPSC incident patterns for household products and rooms \u2014 hazard profiles, prevention checklist, safety product recommendations", "parameters": [ { "name": "product", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "room", "in": "query", "required": false, "schema": { "type": "string" }, "description": "kitchen | bedroom | bathroom | garage | nursery" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Home safety report" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.1, "x-agent-use-case": "on-demand" } }, "/api/safe/child": { "get": { "summary": "Child product safety", "description": "CPSC child-focused incident data \u2014 choking, strangulation, button battery hazards, age-group filtering, emergency contacts", "parameters": [ { "name": "product", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "age_group", "in": "query", "required": false, "schema": { "type": "string" }, "description": "infant | toddler | preschool | school-age" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Child safety report" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.08, "x-agent-use-case": "on-demand" } }, "/api/safe/score": { "get": { "summary": "Brand safety score", "description": "Safety grade A-F for a brand based on CPSC incident history, FDA enforcement actions, and recall rate", "parameters": [ { "name": "brand", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "product_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Safety score report" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.08, "x-agent-use-case": "on-demand" } }, "/api/safe/eu": { "get": { "summary": "EU Safety Gate alerts", "description": "EU Safety Gate (RAPEX) product alerts across all 27 member states \u2014 serious risk recalls, CE marking guidance, cross-border availability warnings", "operationId": "safeEU", "security": [ { "x402": [] } ], "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string" }, "description": "toys | electronics | clothing | food | cosmetics | vehicles | all" }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filter by EU country (e.g. Germany, France, Spain)" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "EU product safety alerts" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.08, "x-agent-use-case": "on-demand" } }, "/api/safe/global": { "get": { "summary": "Global safety alerts", "description": "International product safety \u2014 WHO pharmaceutical alerts, Health Canada, ACCC Australia, and UK OPSS in one consolidated report", "operationId": "safeGlobal", "security": [ { "x402": [] } ], "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string" }, "description": "food | drug | device | consumer | all" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string" }, "description": "canada | australia | uk | who | global" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Global product safety alerts" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.1, "x-agent-use-case": "on-demand" } } }, "components": { "securitySchemes": { "x402": { "type": "apiKey", "in": "header", "name": "PAYMENT-SIGNATURE", "description": "x402 micropayment signature. Send request without header to receive 402 with payment requirements." } } } }