Integration guides · snapshots, APIs, warehouses, agents

These patterns follow the dataset contract: snapshot formats, REST paths, MCP tools, field catalog, sample availability, and API examples.

Choose a surface

Snapshot

Best for warehouses, offline analysis, BI tools, and repeatable audit work.

REST API

Best for app backends and services that need current records from /v1/recalls.

MCP

Best for AI agents that need read-only, source-attributed tools.

Snapshot files

Snapshot files are the lowest-friction path for warehouse loading and durable audit trails. The release page describes the current version, sample manifest, and buyer download contract.

JSON snapshot
application/json
CSV snapshot
text/csv
SQLite snapshot
application/x-sqlite3

snapshot workflowbash

# authenticated buyer flow
open /portal/download

# inspect the bundle locally after download
ls -lh *.{json,csv,sqlite,parquet} 2>/dev/null || true

Warehouse loading

Use file formats for bulk analytics. Keep provenance and source fields loaded alongside entity records so downstream users can verify each value.

duckdb / parquetsql

-- Replace dataset.parquet with the shipped file name.
SELECT *
FROM 'dataset.parquet'
LIMIT 20;

pandas / pyarrowpython

import pyarrow.parquet as pq

table = pq.read_table("dataset.parquet")
df = table.to_pandas()
print(df.shape)

REST clients

REST access runs at https://api.recallradar.dev/v1.

curlbash

curl "https://api.recallradar.dev/v1/recalls?limit=5" \
  -H "Authorization: Bearer recallradar_live_····"

fetch.tsts

const res = await fetch("https://api.recallradar.dev/v1/recalls?limit=5", {
  headers: { Authorization: "Bearer recallradar_live_····" },
});
if (!res.ok) throw new Error(String(res.status));
const body = await res.json();

Search strict recalls

Search authenticated production access for strict recall records.

manifest examplebash

curl "https://api.recallradar.dev/v1/recalls?q=Galmet%20ColdGal%20Brushable%20Paint&is_recall=true&limit=5" \
  -H "Authorization: Bearer recallradar_live_····"

Fetch one safety notice

Inspect one safety notice with classification, hazards, remedy text, and provenance.

manifest examplebash

curl "https://api.recallradar.dev/v1/recalls/57500" \
  -H "Authorization: Bearer recallradar_live_····"

List authorities

Inspect the source authorities and licence facts behind the delivered dataset.

manifest examplebash

curl "https://api.recallradar.dev/v1/sources" \
  -H "Authorization: Bearer recallradar_live_····"

MCP agents

MCP exposes read-only tools over https://api.recallradar.dev/mcp. The protocol is harness agnostic, while each client wraps the HTTP URL and bearer token differently. See the MCP client configuration guide for Claude, OpenAI Codex, Google Gemini CLI, and Cursor examples.

recalls_searchSearch consumer-product safety notices by free text, authority, jurisdiction, category, hazard, manufacturer, publish date, or strict-recall classification.
recalls_getFetch one safety notice by id with strict-recall classification, affected products, responsible parties, hazards, remedy, and per-field provenance.
recalls_sourcesList the source authorities (CPSC, EU Safety Gate, Health Canada, GOV.UK OPSS, ACCC, and France RappelConso) with licence and attribution.
recalls_coverageInspect measured authority, category, jurisdiction, classification, and field coverage across the safety-notice corpus.

Field selection

Start integrations with stable, high-value fields from the generated schema catalog. For the complete table, use the data dictionary.

authority

Source authority code, such as cpsc, eu-safety-gate, health-canada, gov-uk-opss, accc, fr-rappelconso, tw-bsmi, or fi-tukes-historical.

Unique numeric notice identifier within RecallRadar.

source_notice_ref

Authority-specific reference number or ID, such as a CPSC recall number or RAPEX alert ID.

is_recall

True when the notice is a formal recall; false for alerts or warnings that stop short of recall.

category_source

Category source value emitted by the recalls export. Use the record provenance payload to inspect source attribution when populated.

country_of_origin

Country of origin value emitted by the recalls export. Use the record provenance payload to inspect source attribution when populated.

jurisdiction

Jurisdiction value emitted by the recalls export. Use the record provenance payload to inspect source attribution when populated.

risk_level

Risk level value emitted by the recalls export. Use the record provenance payload to inspect source attribution when populated.

Evaluation path

The sample bundle is published with 150 rows. Use it to validate schema, source provenance, and integration ergonomics before buying the production snapshot.

A good first production smoke test is /v1/recalls?q=Galmet%20ColdGal%20Brushable%20Paint&is_recall=true&limit=5: Search authenticated production access for strict recall records.

Integration caveats

RecallRadar is reference data, not legal advice, product-safety certification, or recall-management advice.
Buyers remain responsible for validating source notices and regulatory obligations in their own jurisdiction.
The dataset covers selected consumer-product authorities and excludes food, drug, vehicle, agriculture, and unlisted global sources.

Need a stack-specific example? Email data@apex-db.org.