FTC for Developers

Overview

  • 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. 

API

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

FTC is working to resolve an issue that prevents the distribution of the API key via email after completion of the request form. The issue should be fixed by Friday, March 1. If you have submitted a request and have not received your API key, please resubmit the request using the form on or after March 1. Thank you for your patience.

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.

Loading signup form...

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):

https://api.ftc.gov/v0/hsr-early-termination-notices?api_key=DEMO_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.

Endpoints

FTC will develop new endpoints on a gradual basis and welcomes suggestions.

API EndpointDescription of Endpoint
/v0/hsr-early-termination-noticesHSR 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.

Datasets

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

Contact Us

  • Questions, comments or suggestions? Email us.