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 being deprecated and will not be available after November 30, 2016.
Enterprise contour API is available effective November 1, 2016.





FCC Contour API is being deprecated and will not be available after November 30, 2016.
Enterprise contour API is available effective November 1, 2016.







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"}]