# SafePulse

> Universal product safety intelligence API. 7 endpoints covering active recalls, consumer product safety, vehicle safety, food/drug recalls, home hazards, child product safety, and brand safety scoring. Primary sources: CPSC SaferProducts.gov, FDA openFDA, USDA FSIS, NHTSA. All free, official US government data. Pay-per-query via x402 on Base.

## What This Is

SafePulse is a pay-per-query API that synthesizes data from every major US product safety agency into structured, actionable intelligence. It answers the questions that matter: Is this product safe? Has this brand had recalls? Is this vehicle safe to buy? Should I eat this recalled food?

Data sources: CPSC SaferProducts.gov (consumer product incidents), FDA openFDA (food/drug/device enforcement), USDA FSIS (meat/poultry/egg recalls), NHTSA (vehicle crash ratings, recalls, complaints), and real-time news via Tavily.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Endpoints

GET /api/safe/recall?category={all|food|drug|vehicle|product}
- Active recall dashboard — FDA food, FDA drug, USDA FSIS, and NHTSA/CPSC recall news consolidated
- Returns: recall_summary, most_urgent (with action), food_recalls, drug_recalls, meat_poultry_recalls, vehicle_alerts, consumer_product_alerts, class_explanation, verification_links
- category optional; defaults to all
- Price: $0.08

GET /api/safe/product?product={name}&category={toys|furniture|appliances|electronics|clothing}
- Consumer product safety lookup — CPSC incident history, hazard patterns, safer alternatives
- Returns: safety_verdict (safe|use_with_caution|avoid|insufficient_data), incident_summary (injuries/deaths), key_hazards, recall_history, safer_alternatives with Amazon URL, certifications_to_look_for, prevention_tips
- product or category required
- Price: $0.08

GET /api/safe/vehicle?make={make}&model={model}&year={year}
- Vehicle safety deep dive — NHTSA crash ratings, all recalls, complaint pattern analysis
- Returns: overall_safety_verdict, crash_ratings (stars), recalls (with remedy), complaints (common_issues synthesized), buy_guidance, safety_upgrades (dash cam, TPMS) with Amazon URLs
- make, model, year all required
- Price: $0.10

GET /api/safe/food?product={name}&type={food|drug|supplement|all}
- Food and drug recall intelligence — FDA enforcement + USDA FSIS
- Returns: safety_status (active_recall|monitor|no_current_action), active_recalls (with Class I/II/III), contamination_risk, class_i_warning, allergen_note, what_to_do, safer_storage with food thermometer Amazon URL
- product required; type optional
- Class I = serious health risk or death possible — always flagged prominently
- Price: $0.08

GET /api/safe/home?product={product}&room={kitchen|bedroom|bathroom|garage|nursery}
- Home hazard intelligence — CPSC incident patterns by product or room
- Returns: hazard_verdict, hazard_profile (with hazard_type/severity/who_at_risk), incident_patterns, prevention_checklist (specific actions), room_specific_risks, safety_products (smoke/CO, fire extinguisher, hazard-specific) with Amazon URLs
- product or room required
- Price: $0.10

GET /api/safe/child?product={name}&age_group={infant|toddler|preschool|school-age}
- Child product safety — CPSC incidents filtered for child hazards, age-group filtering
- Returns: child_safety_verdict, incident_summary (child-specific incidents/deaths), hazard_types (choking/strangulation/button_battery etc.), active_recalls, cpsc_warnings, age_appropriate_guidance, safer_alternatives with Amazon URL, baby_proofing kit URL, emergency contacts (Poison Control 1-800-222-1222)
- product required; age_group optional
- Deaths in data → verdict is always 'unsafe'
- Button battery ingestion: always flagged as requires ER immediately
- Price: $0.10

GET /api/safe/score?brand={brand}&product_type={type}
- Brand safety score A-F based on CPSC incidents, FDA enforcement actions, recall history
- Returns: safety_grade (A-F), safety_score (0-100), score_basis, incident_record (injuries/deaths/recall_count), recall_history, risk_factors, positive_factors, comparison to category peers, how_to_verify links
- brand required; product_type optional
- No data found → C grade (not A) with note about data limitations
- Price: $0.12

GET /api/safe/eu?category={category}&country={country}
- EU Safety Gate (RAPEX) alerts — serious-risk product recalls across all 27 EU member states
- Returns: alert_summary, serious_risk_alerts (product/hazard/risk_level/countries_notified/action_required), categories_with_most_alerts, origin_patterns, ce_marking_guidance, cross_border_note, verification_links, this_week_action
- category optional (toys | electronics | clothing | food | cosmetics | vehicles | all); country optional (Germany, France, etc.)
- Note: products recalled in one EU country are often still on sale in others — cross-border_note covers this
- Price: $0.08

GET /api/safe/global?category={category}&region={region}
- Global product safety — WHO pharmaceutical alerts, Health Canada, ACCC Australia, UK OPSS consolidated
- Returns: global_summary, who_alerts, canada_alerts, australia_alerts, uk_alerts, cross_border_patterns, regulatory_differences, verification_links
- category optional (food | drug | device | consumer | all); region optional (canada | australia | uk | who | global)
- Price: $0.10

## Discovery

- OpenAPI spec: https://safepulse.vercel.app/openapi.json
- Agent discovery: https://safepulse.vercel.app/.well-known/agent.json

## Notes for AI Agents

- Pre-purchase safety flow: /api/safe/score → /api/safe/product → /api/safe/recall (for active alerts)
- Vehicle purchase flow: /api/safe/vehicle → /api/safe/recall?category=vehicle
- Child safety audit: /api/safe/child → /api/safe/recall?category=product → /api/safe/home?room=nursery
- Food safety check: /api/safe/food → /api/safe/recall?category=food
- EU consumer check: /api/safe/eu (category, country) — covers 450M people not served by US-only endpoints
- International traveler/expat check: /api/safe/global → /api/safe/eu
- /api/safe/child always includes Poison Control (1-800-222-1222) and CPSC hotline (1-800-638-2772)
- /api/safe/vehicle requires make + model + year; NHTSA is US-focused
- /api/safe/score with no data returns grade C, not A — absence of records ≠ safety
- All endpoints support ?lang= for native-language responses
- Amazon affiliate links are contextually placed (safer replacement products, safety equipment)