# ParentPulse

ParentPulse is an x402-gated parenting intelligence API for parents and family/parenting agents worldwide. All endpoints return structured JSON and require micropayment via the x402 protocol (USDC on Base mainnet). Guidance is globally aware — every endpoint accepts an optional `country` parameter and adapts terminology, regulators, and support programs accordingly (never assumes the US).

## Endpoints

- GET /api/parent/milestone?age_months=18&concern=speech-delay&country=UK — WHO/CDC-grounded developmental milestone context, red flags, and country-matched early intervention program (US Part C, UK SEND, Canada, Australia NDIS) ($0.10)
- GET /api/parent/safety?product_type=car-seat&brand=Graco&country=US — Product recall lookup across CPSC/NHTSA (US), Safety Gate (EU), OPSS (UK), Health Canada, ACCC (Australia) ($0.08)
- GET /api/parent/school?zip=78701&grade=K&priorities=academics,arts&country=US — School comparison by location, grade, and priorities, with country-matched school-system types and rating tools (Ofsted/My School/GreatSchools) ($0.10)
- GET /api/parent/activity?age=7&interests=soccer,art&budget=200&zip=78701&country=US — Age-appropriate extracurriculars with currency-aware cost and developmental benefits ($0.08)
- GET /api/parent/finance?children=2&ages=3,6&income=120000&country=Canada — Education savings (529/RESP/JISA-CTF), child benefit programs (Child Tax Credit/CCB/Child Benefit/Kindergeld), dependent-care support, and cost-of-raising projections by country ($0.12)
- GET /api/parent/health?age_months=18&symptoms=fever,rash&country=UK — Pediatric symptom triage with urgency level and the correct local emergency number (911/999/112/000/119) ($0.10)
- GET /api/parent/sleep?age_months=6&situation=night-waking&country=US — Sleep guidance by age, safe-sleep basics, training methods, and regression support ($0.10)
- GET /api/parent/nutrition?age_months=18&concern=picky-eater&country=US — Pediatric nutrition and feeding guidance by age, sourced from WHO/AAP/NHS-style guidelines ($0.10)
- GET /api/parent/discipline?age=4&behavior=tantrums&country=US — Positive discipline strategies and in-the-moment scripts ($0.10)
- GET /api/parent/childcare?zip=78701&age_months=12&budget=2000&country=UK — Daycare vs nanny vs au pair vs childminder comparison with local cost ranges and country-specific subsidy programs ($0.12)

## Payment

All endpoints use the x402 protocol. Include a valid PAYMENT-SIGNATURE header. Without payment, endpoints return HTTP 402 with payment requirements. Amounts are in USDC on Base mainnet (6 decimals: 100000 = $0.10).

## Parameters

- All endpoints accept `country` (ISO code or country name) for jurisdiction-aware guidance — regulators, benefit programs, school systems, and emergency numbers all adapt. Omitting it returns a generic or US-fallback response, clearly labeled as such.
- All endpoints accept `lang` for response language (Claude responds natively in any language).
- Existing parameters (zip, age, age_months, income, budget, etc.) are unchanged and backward-compatible.

## Notes

- Data sourced from WHO, CDC, AAP, NHS, CPSC/NHTSA, Safety Gate (EU), OPSS (UK), Health Canada, ACCC (Australia), and real-time Tavily search
- All responses include disclaimer fields — always consult qualified professionals for medical, educational, and financial decisions
- /api/parent/health urgency_level field: emergency | go_to_ER | urgent_care_today | call_doctor | home_care_monitor; emergency_number field gives the correct local number
- Models never generate URLs — only organization/program names as search terms; links are added by the system after synthesis

## Discovery

- OpenAPI: /openapi.json
- Agent discovery: /.well-known/agent.json
- Part of PulseNetwork — 30+ AI intelligence APIs