ParentBriefing API Documentation

Overview

The ParentBriefing API provides programmatic access to the same safety data that powers our daily briefings. Use it to build apps, dashboards, or integrations that help keep families safe.

Base URL

parentbriefing.com/api/v1

Authentication

None

Rate Limit

100 req/hr

Format

JSON

Endpoints

GET /api/v1/recalls.php

Returns product safety recalls from the U.S. Consumer Product Safety Commission (CPSC).

Parameters

Param	Type	Default	Description
`limit`	int	10	Results to return (max 50)
`days`	int	—	Filter to last N days
`search`	string	—	Keyword search in title, description, contact

Example

# Get the 5 most recent recalls
curl "https://parentbriefing.com/api/v1/recalls.php?limit=5"

# Search for recalls mentioning "stroller"
curl "https://parentbriefing.com/api/v1/recalls.php?search=stroller"

# Recalls from the last 7 days
curl "https://parentbriefing.com/api/v1/recalls.php?days=7"

GET /api/v1/food-alerts.php

Returns FDA food recall and safety alerts.

Parameters

Param	Type	Default	Description
`limit`	int	10	Results to return (max 50)
`days`	int	—	Filter to last N days
`search`	string	—	Keyword search in product, reason, firm
`state`	string	—	Filter by US state code (e.g. TX, CA)

Example

# Get food alerts from Texas
curl "https://parentbriefing.com/api/v1/food-alerts.php?state=TX"

# Search for salmonella-related alerts
curl "https://parentbriefing.com/api/v1/food-alerts.php?search=salmonella&limit=20"

GET /api/v1/safety-alerts.php

Combined feed of both product recalls and food alerts, sorted by date. Each item includes a type field: product_recall or food_alert.

Parameters

Param	Type	Default	Description
`limit`	int	20	Results to return (max 50)
`days`	int	—	Filter to last N days
`search`	string	—	Keyword search across all fields
`type`	string	—	Filter: `recall` or `food`

Example

# Get all safety alerts from the last 30 days
curl "https://parentbriefing.com/api/v1/safety-alerts.php?days=30"

# Only food alerts
curl "https://parentbriefing.com/api/v1/safety-alerts.php?type=food&limit=10"

GET /api/v1/index.php

Returns a JSON description of all available endpoints, parameters, and usage examples. Useful for programmatic discovery.

curl "https://parentbriefing.com/api/v1/"

Response Format

All endpoints return JSON with a consistent envelope:

{ "status": "ok", "count": 5, "data": [ ... ], "source": "ParentBriefing.com", "updated": "2026-04-18" }

On error:

{ "status": "error", "message": "Rate limit exceeded. Max 100 requests per hour.", "retry_after": 2400 }

Rate Limits

The API allows 100 requests per hour per IP address. No API key is needed. If you exceed the limit, you will receive a 429 response with a Retry-After header indicating how many seconds to wait.

Responses include a Cache-Control: public, max-age=3600 header — caching on your end is encouraged.

CORS

All endpoints include Access-Control-Allow-Origin: * headers, so you can call the API directly from browser-based JavaScript applications.