Developers - Frequently Asked Questions (FAQs)

Developers - SaferProducts API information

Access to the Consumer Product Safety Information Database is simple and free. Follow these steps:

The SaferProducts.gov API provides access to all publically available information visible on SaferProducts.gov. Here is the information that is provided:

  • Incident - Incident Report Number, Incident Date, Incident Location, Incident Description, Incident Report Publication Date, Locale
  • Manufacturer - Manufacturer Name, Manufacturer Location, Manufacturer Notification Date, Manufacturer comments
  • Product - Product Brand Name, Product Model Name, Product Manufactured Date, Product Purchased Date, Incident Product Description
  • Retail Company - Retail Company Name, Retail Company Location
  • Victim - Victim Gender, Victim Age

In addition, CPSC has a Recalls API. The Recalls API provides the following fields of information: Recall Number, Company, Product Type, Product Description, Hazard, County/Administrative Area of Manufacture, Recall Date, UPC (when provided in a recall). Here’s the full documentation on the Recalls API.

How do I access the SaferProducts.gov API from my application?

The SaferProducts.gov API uses the Open Data Protocol(OData) standard to query the database. OData is an open standard that is available on many platforms including .NET, Java and PHP. For more information on OData, please refer to www.odata.org

Where can I find development information on Open Data Protocol (OData)?

The OData website has extensive information about using OData data sources in different client environments. You can find that information on www.odata.org/developer

Where do I find information about the data model used in the SaferProducts.gov API?

The data model is at http://www.saferproducts.gov/webapi/Cpsc.Cpsrms.Web.Api.svc/$metadata

Microsoft also made a Visual Studio plugin that allows you to visualize the data model directly from the service reference. Find more information on the WCF Data Services blog at http://blogs.msdn.com/b/astoriateam/archive/2009/11/17/introducing-the-microsoft-open-data-protocol-visualizer.aspx

Can you give some simple examples on how to access the SaferProducts.gov API from a browser?

The following link shows one page of Incident Reports: http://www.saferproducts.gov/WebAPI/Cpsc.Cpsrms.Web.Api.svc/IncidentDetails
For a full list of the OData syntax, please refer to http://www.odata.org/developers/protocols/uri-conventions

My browser doesn’t show any records, just a list of dates. Why?

The SaferProducts.gov API uses OData which in turn uses the Atom feed protocol. Most browsers try by default to display the feed in a user friendly manner. This feature can be disabled to see all of the data returned by the API call.

In Internet Explorer, go into the InterNet Options, Content Tab, Feeds and Web Slices Section and click on Settings. Uncheck ‘Turn on feed reading view’ and click OK. Close and re-open Internet Explorer and type the query URL once more.

In FireFox, Google Chrome doesn’t format Atom feeds by default, so you should not need to change settings to see all of the information.

Back to Top

Read More FAQs


CPSC does not guarantee the accuracy, completeness, or adequacy of the contents of the Publicly Available Consumer Product Safety Information Database on SaferProducts.gov, particularly with respect to information submitted by people outside of CPSC.