# Product Safety & Recalls API > Search CPSC, EU Safety Gate, UK FSA and Canada recalls, look up USDA FoodData nutrition, and parse GS1 Digital Link URIs from vendored official data or pure computation. Each paid operation uses a fixed USDC price on Base with the x402 exact scheme. Unpaid GET, HEAD, and POST return 402 payment terms (POST validates the body only after payment terms are satisfied). A request that carries payment-signature is not yet charged: settlement happens only after a successful (2xx) result. HTTP 4xx/5xx are not charged. Coverage bodies with status complete, partial, or failed all return HTTP 200 and are charged at the full listed price. Settled 2xx responses include a payment-response header; 4xx/5xx do not. Follow https://www.brainiac.software/agent-instructions.txt for install, payment pins, idempotency, and billing rules. - Product: https://www.brainiac.software/api/product-safety - Docs: https://www.brainiac.software/api/product-safety/docs - OpenAPI: https://www.brainiac.software/api/product-safety/openapi.json - Contact: support@brainiac.software (https://www.brainiac.software/contact) ## Operations ### POST /api/v1/product-safety/cpsc-recall-search $0.03 USDC. Search US CPSC recalls by keyword, firm, recall number, UPC or date range in the vendored snapshot. Inputs: query?, recallNumber?, upc?, firm?, from?, to?, limit? Docs: https://www.brainiac.software/api/product-safety/docs#product-safety-cpsc-recall-search Example request: ```json { "recallNumber": "27082" } ``` Example response: ```json { "count": 1, "recalls": [ { "recallId": 11060, "recallNumber": "27082", "recallDate": "2026-11-12", "title": "Allstar Recalls Sharper Image Tabletop and Infinity Fire Pits Due to Risk of Serious Injury from Burn and Fire Hazards", "url": "https://www.cpsc.gov/Recalls/2027/Allstar-Recalls-Sharper-Image-Tabletop-and-Infinity-Fire-Pits-Due-to-Risk-of-Serious-…", "products": [ { "name": "Sharper Image Tabletop Fire Pits and Sharper Image Tabletop Infinity Fire Pits", "type": "Outdoor Patio Heaters or Firepits (Manufactured)", "categoryId": "895", "numberOfUnits": "About 265,000" } ], "importers": [ "Allstar Marketing Group, LLC, of Winston-Salem, North Carolina" ], "manufacturerCountries": [ "China" ] } ], "snapshotDate": "2026-11-15", "sources": [ { "source": "CPSC Recalls Retrieval Web Service", "url": "https://www.saferproducts.gov/RestWebServices/Recall?format=json", "retrievedAt": "2026-11-15", "status": "ok" } ], "limitations": [ "Results read the vendored CPSC recall snapshot; saferproducts.gov is not called at request time." ] } ``` ### POST /api/v1/product-safety/eu-safety-gate-alert $0.03 USDC. Search EU Safety Gate (RAPEX) non-food product alerts from vendored English weekly reports since 2024. Inputs: barcode?, brand?, query?, category?, riskType?, notifyingCountry?, level?, from?, to?, limit? Docs: https://www.brainiac.software/api/product-safety/docs#product-safety-eu-safety-gate-alert Example request: ```json { "barcode": "5054298241091" } ``` Example response: ```json { "count": 1, "alerts": [ { "caseNumber": "SR/03208/26", "publicationDate": "2026-11-10", "alertUrl": "https://ec.europa.eu/safety-gate-alerts/screen/webReport/alertDetail/10118633", "category": "Clothing, textiles and fashion items", "product": "Children's jacket", "brand": "Jojo Maman Bébé", "name": "Baby Jacket Flower", "modelOrType": "C52-683-145-000161", "barcode": "5054298241091", "riskType": "Chemical, Environment", "notifyingCountry": "Luxembourg", "countryOfOrigin": "People's Republic of China", "level": "Serious risk", "weeklyReport": "Report-2026-45" } ], "snapshotDate": "2026-11-15", "sources": [ { "source": "EU Safety Gate weekly report XML (EN)", "url": "https://ec.europa.eu/safety-gate-alerts/api/download/weeklyReport/list/xml/en", "retrievedAt": "2026-11-15", "status": "ok" } ], "limitations": [ "Only English weekly reports from 2024 onward are vendored; earlier RAPEX history is not searched." ] } ``` ### POST /api/v1/product-safety/fsa-allergy-alert-search $0.03 USDC. Search UK FSA allergy alerts, product recall information notices and food alerts for action. Inputs: allergen?, query?, business?, alertType?, from?, to?, limit? Docs: https://www.brainiac.software/api/product-safety/docs#product-safety-fsa-allergy-alert-search Example request: ```json { "allergen": "milk", "business": "Tesco", "from": "2026-11-01" } ``` Example response: ```json { "count": 1, "alerts": [ { "id": "FSA-AA-53-2026", "type": "AA", "title": "Tesco recalls various Tesco Steak and Guinness Pie products because of undeclared milk", "created": "2026-11-13", "alertUrl": "https://www.food.gov.uk/news-alerts/alert/FSA-AA-53-2026", "business": "Tesco", "allergens": [ { "notation": "milk", "label": "Milk" } ], "products": [ { "name": "Tesco Steak and Guinness Pie", "packSize": "200g" } ] } ], "snapshotDate": "2026-11-15", "sources": [ { "source": "FSA Food Alerts full view", "url": "https://data.food.gov.uk/food-alerts/id?_limit=5000&_view=full", "retrievedAt": "2026-11-15", "status": "ok" } ], "limitations": [ "Food Standards Scotland-only alerts are not in this feed." ] } ``` ### POST /api/v1/product-safety/canada-health-recall-search $0.03 USDC. Search Government of Canada Recalls and Safety Alerts open data in English or French. Inputs: query?, organization?, category?, recallClass?, includeArchived?, language?, from?, to?, limit? Docs: https://www.brainiac.software/api/product-safety/docs#product-safety-canada-health-recall-search Example request: ```json { "query": "Jack'd Up Bites" } ``` Example response: ```json { "count": 1, "recalls": [ { "nid": 82929, "title": "Certain Plantropy brand Jack’d Up Bites Crispy Protein Bites recalled due to undeclared milk", "url": "https://recalls-rappels.canada.ca/en/alert-recall/certain-plantropy-brand-jack-bites-crispy-protein-bites-recalled-due-…", "organization": "CFIA", "issue": "Milk", "category": "Candy, confectionary, snacks and sweeteners", "recallClass": "Class 1", "lastUpdated": "2026-11-13", "archived": false } ], "snapshotDate": "2026-11-15", "sources": [ { "source": "Government of Canada Recalls and Safety Alerts open data", "url": "https://recalls-rappels.canada.ca/sites/default/files/opendata-donneesouvertes/HCRSAMOpenData.csv", "retrievedAt": "2026-11-15", "status": "ok" } ], "limitations": [ "Archived rows are excluded unless includeArchived is true." ] } ``` ### POST /api/v1/product-safety/usda-fooddata-nutrition $0.03 USDC. Return nutrient values per 100 g from USDA FoodData Central Foundation Foods and SR Legacy. Inputs: fdcId?, query?, dataType?, nutrients?, limit? Docs: https://www.brainiac.software/api/product-safety/docs#product-safety-usda-fooddata-nutrition Example request: ```json { "fdcId": 173410, "nutrients": [ "Energy", "Protein", "Total lipid (fat)", "Carbohydrate, by difference", "Sodium, Na" ] } ``` Example response: ```json { "foods": [ { "fdcId": 173410, "description": "Butter, salted", "dataType": "SR Legacy", "per100g": [ { "name": "Energy", "unit": "kcal", "amount": 717 }, { "name": "Energy", "unit": "kJ", "amount": 3000 }, "…" ] } ], "sources": [ { "source": "USDA FoodData Central Foundation Foods + SR Legacy", "url": "https://fdc.nal.usda.gov/download-datasets", "retrievedAt": "2026-11-15", "status": "ok" } ], "limitations": [ "Branded and FNDDS survey foods are not vendored." ] } ``` ### POST /api/v1/product-safety/gs1-digital-link-parse $0.01 USDC. Parse an uncompressed GS1 Digital Link URI into primary key, qualifiers and attributes; return canonical URI and element string. Inputs: uri Docs: https://www.brainiac.software/api/product-safety/docs#product-safety-gs1-digital-link-parse Example request: ```json { "uri": "https://example.com/01/09520123456788/10/ABC1/21/12345?17=180426&linkType=gs1:traceability" } ``` Example response: ```json { "valid": true, "primaryKey": { "ai": "01", "title": "GTIN", "value": "09520123456788" }, "qualifiers": [ { "ai": "10", "title": "BATCH/LOT", "value": "ABC1" }, { "ai": "21", "title": "SERIAL", "value": "12345" } ], "attributes": [ { "ai": "17", "title": "USE BY or EXPIRY", "value": "180426" } ], "otherParams": { "linkType": "gs1:traceability" }, "canonicalUri": "https://id.gs1.org/01/09520123456788/10/ABC1/21/12345?17=180426", "elementString": "(01)09520123456788(17)180426(10)ABC1(21)12345", "errors": [], "sources": [ { "source": "GS1 Digital Link URI Syntax 1.7.0 + Barcode Syntax Dictionary", "url": "https://ref.gs1.org/standards/digital-link/uri-syntax/", "retrievedAt": "2026-11-15", "status": "ok" } ] } ```