- The Federal Trade Commission has for some years provided high-value datasets in various file formats to the public to support transparency, participation, and collaboration. The agency is committed to providing its data and information in a machine-readable and standard, open format to facilitate the widest possible dissemination of its content to the public and government agencies. This commitment aligns with the FTC’s Open Government Plan and Strategic Plan. To this end, the FTC has begun identifying datasets that can be made available via an Application Programming Interface (API), which enables developers to query, gather, and manipulate the FTC’s data.
- The FTC’s first API endpoint is for Early Termination Notices, which are released most weekdays and are among the most popular content on FTC.gov. They are related to the Hart-Scott-Rodino (HSR) Act’s requirements for companies concerning mergers and acquisitions. Learn more about the Premerger Notification Program and Early Termination Notices and get the technical details for the HSR Early Termination Notices API endpoint.
- The current data sets provided by the FTC can be found on FTC.gov and Data.gov
An API (or Application Programming Interface) allows a website or software program to accept requests from an external source and send back responses to those requests. While a dataset file may contain several thousand rows of data that needs to be manually searched, an API allows you to request only the data you're interested in (by including filter criteria, such as a date range, keyword or specific transaction number). The FTC API is a Web API, which means that requests are sent via URLs and responses are provided in the content at those URLs. You can find out more about APIs here: Introduction to APIs in Government
The FTC API is read-only and allows various types of data to be requested, including the content that appears throughout the FTC website. Each type of data or content is accessible through a dedicated URL, commonly referred to as an "API endpoint".
The URL path for the API is: https://api.ftc.gov/v0
The current API version is v0, indicating that the API is under active development - some aspects of the API may change, such as the filter syntax used in requests or the structure of response data. All API responses are in JSON format.
Getting Started with the FTC API
1. Register for a Data.gov API key using the API Key Signup Form below. You will receive a confirmation email with your API key shortly after. In addition to allowing you to access the FTC API, this key can also be used to access other participating APIs listed on Data.gov.
2. Make an API call to one of the endpoints listed in the API Endpoints section below, with your Data.gov API key included as a URL query parameter. For example, the following URL will make an API call to the HSR Early Termination Notices API endpoint (replace DEMO_KEY with your Data.gov API key):
NOTE: you may also provide your Data.gov API key in an X-Api-Key header or using HTTP Basic Auth - see the Data.gov API Key page for more details.
FTC will develop new endpoints on a gradual basis and welcomes suggestions.
|API Endpoint||Description of Endpoint|
|/v0/hsr-early-termination-notices||HSR Early Termination Notices - This endpoint allows you to pull granted Early Terminations data in real-time and filter by multiple parameters. Under the Hart-Scott-Rodino (HSR) Act, parties to certain large mergers and acquisitions must file premerger notification and wait for government review. The parties may not close their deal until the waiting period outlined in the HSR Act has passed, or the government has granted early termination of the waiting period.|
FTC offers a variety of datasets for public use, including those related to merger filings, merger/nonmerger enforcement actions, civil penalty actions, and Do Not Call complaints. In general, files are provided in either CSV or XLS format. Datasets can be downloaded from the following pages:
Developer News & Updates
- Questions, comments or suggestions? Email us.