API Documentation for Developers

This page is for developers. We built this site entirely off the APIs (Application Programming Interfaces) below and we want to share them with you. The APIs below are provided so that you can further drive the data across the public and private sectors through your own applications. Our APIs are free for use by anyone subject to your acceptance of the API usage terms and conditions as well as any relevant sections of the FCC.gov Website Policies and Privacy Policy.

These online tools will empower developers across the country to leverage government data in ways never imagined, creating immense value for the American public.

If you use our APIs, please indicate the source on your page. Also, don't forget to tell us how you have used our platform in your projects! Send email to: developer@fcc.gov.





FCC Contour API is deprecated and is no longer available and was replaced by Enterprise Contour API.
Enterprise contour API documentation.





File Search Filters


Type of Ads
Political Ads
{"political_file_type":"PA"}
Non Candidate Issue Ads
{"political_file_type":"NCIA"}
Office
Presidential
{"office_type":"Presidential"}
US Senate
{"office_type":"US Senate"}
US House
{"office_type":"US House"}
State
{"office_type":"State"}
Local
{"office_type":"Local"}
Campaign Year
Example: 2016
{"campaign_year":"2016"}
Entity Type
TV
{"source_service_code":"TV"}
FM
{"source_service_code":"FM"}
AM
{"source_service_code":"AM"}
Cable
{"source_service_code":"CABLE"}
DBS Satellite Radio
{"source_service_code":"DBS"}
SDARS Satellite TV
{"source_service_code":"SDARS"}
Major TV Networks
ABC
{"network_affiliation":"ABC"}
NBC
{"network_affiliation":"NBC"}
CBS
{"network_affiliation":"CBS"}
FOX
{"network_affiliation":"FOX"}
TV Market Areas
Example: Baltimore
{"nielsen_dma_rank":"BALTIMORE"}
Date Range
MM/DD/YYYY -
MM/DD-YYYY
{"create_ts":"01/01/2015 - 01/01/2016"}

More Public Files
Example: Childrens TV Programming Reports
{"non_political_file_folder":"Childrens TV Programming Reports"}

Multiple filter combination example:
Example:
Federal documents on TV stations within ABC network, for the campaign years 2014 and 2016
f=[{"office_type":"Federal"},{"source_service_code":"TV"},{"network_affiliation":"ABC"},{"campaign_year":"2014"},{"campaign_year":"2016"}]