USA.gov Releases Corporate Consumer Contact API

Janet Wagner, Data Journalist / Full Stack Developer
Aug. 21 2014, 11:24AM EDT

USA.gov has just released an API that allows programmatic access to a curated list of contact information for consumer-related corporations. The new USA.gov Corporate Consumer Contact API returns data that is based on the corporate consumer contact information found in the USA.gov Consumer Action Handbook, PDF format.

This new API for accessing consumer-related corporate information was developed for the Consumer Complaint Letter Wizard, a tool available on the USA.gov site that helps consumers through the process of filing a complaint about a product or service they purchased. The new Corporate Consumer Contact API is based on the Federal Agency Directory API, an API that allows programmatic access to directory information about federal agencies, including contact methods.

home-depot

Interactive documentation for the USA.gov Corporate Consumer Contact API is powered by Swagger

The API has two endpoints (contacts and contacts/identifier), and parameters include query_filter, result_filter, sort and X-Range HTTP Request Header. Also available is interactive documentation, powered by Swagger, that developers can use to try out the different parameters of the API. The API is capable of returning responses in JSON, JSONP or XML format.

At the time of this writing, the "name" parameter used in the API call must be spelled exactly the same as the listing in the Consumer Action Handbook PDF. For example, a successful API call for Home Depot would use the name "Home Depot, Inc." not "Home Depot."

For more information about the Corporate Consumer Contact API and to see the other APIs available on USA.gov, visit the Developer Resources Site.

Janet Wagner is a data journalist and full stack developer based in Toledo, Ohio. Her focus revolves around APIs, data visualization, machine learning, and data-driven journalism. Follow her on Twitter: @webcodepro, Google+, or send her an email.

Comments