Skip Navigation

Federal Communications Commission

English Display Options

FCC Content API

Description

FCC.gov uses the Drupal Content API Module to make hundreds of thousands of Commission documents available to the public, in addition to all of the content on FCC.gov. Drupal developers can use the module on their own site to publish all of the site's content without any programming.
 
The Drupal Content API Module is completely dynamic, publishing your content as an API even as your site structure and content changes. The module is integrated with CCK and will discover new fields when added, and provides granular permissions.
 
The module makes the following query parameters searchable:
  • type
  • title
  • author
  • content fields
  • relationship (including taxonomy term)

Why We Provide It

Organizing, searching and finding important content in the volume of documents which are published by the Commission is a daunting task. The Content API module makes your content accessible to any application or platform, while leveraging Drupal’s strengths as a content management system. Encouraging the ability to easily publish content to multiple applications and devices promotes transparency and accessibility.

Usage Documentation

FCC.gov’s content is accessible via the Content API. All content can be accessed at http://fcc.gov/api/content.json
 

Output formats

Support for json and jsonp
jsonp: add .jsonp and a callback=[function] parameter. If no callback parameter is passed, regular json will be returned.

Accessing Content

Call: /api/content.json
       /api/content/id.json
Description: query content using various parameter filters
Parameters:
 
search_string
Searches content titles for the input string.
Returns all content items with “broadband” in the title

type

Search content by type. Alternative format is types[]=[type] to return multiple types.
Returns all blog posts.
 
Available types:
  • edoc (Official Document)
  • event
  • blog_post
  • article (Encyclopedia article)
  • page
  • guide
  • help
  • map
  • report
  • proceeding (Rulemaking)
  • topic
  • video
  • working_paper

terms

Search content by categorization terms.
Bureaus and Offices
  • [8] Administrative Law Judges
  • [9] Communications Business Opportunities
  • [1] Consumer & Governmental Affairs
  • [2] Enforcement
  • [10] Engineering & Technology
  • [11] General Counsel
  • [12] Inspector General
  • [3] International
  • [13] Legislative Affairs
  • [14] Managing Director
  • [4] Media
  • [15] Media Relations
  • [171] Office of Commissioner Attwell Baker
  • [170] Office of Commissioner Clyburn
  • [168] Office of Commissioner Copps
  • [169] Office of Commissioner McDowell
  • [167] Office of the Chairman
  • [5] Public Safety & Homeland Security
  • [16] Secretary
  • [17] Strategic Planning & Policy Analysis
  • [6] Wireless Telecommunications
  • [7] Wireline Competition
  • [18] Workplace Diversity
 
EDOC terms
 
  • [81] Advisory
  • [45] Broadcast Action
  • [44] Broadcast Applications
  • [71] Callsign Changes
  • [42] Citations
  • [79] Compliance Guide
  • [85] Consent Decree
  • [172] Consumer Advisory
  • [73] Court Filing
  • [60] Court Opinion
  • [92] Decision
  • [83] Declaratory Ruling
  • [58] Eb Field Office Nal
  • [63] Erratum
  • [50] Exparte
  • [84] Fact Sheet
  • [246] Fm Windows
  • [88] Fnprm
  • [53] Forfeiture Order
  • [91] Hearing Designation Order
  • [177] Index
  • [86] Initial Decision
  • [57] Letter
  • [54] Lptv Notices
  • [176] M&o
  • [173] Mds Notices
  • [48] Memorandum Opinion And Order
  • [74] Mo&or
  • [175] Moo&a
  • [67] Nal
  • [52] News Release
  • [76] Notice
  • [43] Notice Of Apparent Liability For Forfeiture
  • [89] Notice Of Intent
  • [55] Notice Of Proposed Rulemaking
  • [59] Notice Of Violation
  • [78] O&a
  • [56] Order
  • [62] Order Authorization
  • [174] Order Of Revocation
  • [66] Order On Reconsideration
  • [70] Order On Review
  • [65] Order Proposing Modification
  • [87] Order To Show Cause
  • [41] Order/consent Decree
  • [75] Plan
  • [90] Policy Statement
  • [51] Protective Order
  • [49] Public Notice
  • [72] R&o/nprm
  • [69] Report
  • [47] Report And Order
  • [68] Speech
  • [46] Statement
  • [82] Study
  • [64] Sunshine
  • [80] Tariffs Combined
  • [77] Testimony
  • [61] Warning
 
Topics
 
  • [283] 3G and 4G Wireless
  • [17] 700 MHZ
  • [4209] 800 MHZ
  • [16] 9-1-1 and E 9-1-1
  • [20] Accessibility
  • [21] Advertising
  • [23] AM Radio
  • [25] Antenna
  • [28] Auctions
  • [29] Bill Shock
  • [143] Broadcast Television
  • [33] Cable Television
  • [40] Closed Captioning
  • [284] Competition
  • [43] Complaints
  • [4290] Contracting
  • [3993] Cramming
  • [47] Data
  • [3854] Developers
  • [50] Digital Television
  • [51] Disability
  • [52] Distracted Driving
  • [53] Do Not Call
  • [57] Education
  • [4223] Emergency Communications
  • [288] Energy and Environment
  • [299] Enforcement
  • [60] Equipment Authorization
  • [61] Ex Parte
  • [3910] FCC Reform
  • [4287] Fees
  • [67] FM Radio
  • [4289] FOIA
  • [69] Forms
  • [70] Fraud
  • [71] Frequency Allocation
  • [291] Health Care
  • [31258] Incentive Auctions
  • [292] Indecency and Obscenity
  • [79] Interference
  • [293] International Telecommunications
  • [84] Licensing
  • [294] Lifeline Across America
  • [85] Low Power FM
  • [86] Low Power TV
  • [4286] Maps
  • [87] Measurement Procedures
  • [295] Mergers and Acquisitions
  • [4224] National Broadband Plan
  • [140] Native Nations
  • [95] Obesity
  • [66] Online Filing
  • [105] Online Privacy
  • [285] Online Safety
  • [3915] Open Internet
  • [100] Ownership
  • [297] Parents
  • [4222] Phone Bills
  • [108] Radio
  • [111] Relay Services
  • [119] Rural Access
  • [121] Satellite
  • [126] Slamming
  • [258] Small Business
  • [298] Smart Grid
  • [127] Spam
  • [136] Telemarketing
  • [137] Telephone
  • [138] Texting
  • [4285] Tools
  • [154] Tower
  • [3907] Universal Service Fund
  • [3908] V-Chip
  • [150] Voice over Internet Protocol (VoIP)
  • [3913] White Space
  • [152] Wireless
  • [153] Wireless Microphone
Query Parameters
  • terms[]=[term id]
    • Search for content based on specific term IDs. A list of the available terms can be found in the Edoc Terms and Bureaus and Offices sections above.
    • Example Request for “Administrative Law Judges” content
    • Example Return
      • [{"count":"12","pages":1,"itemsPerPage":10,"currentPage":0},{"nid":"37043","title":"Initial Decision of Chief ALJ Sippel","created":"2011-12-20","changed":"2011-12-21","type":"edoc","webUrl":"http:\/\/www.fcc.gov\/document\/initialdecision-chief-aljsippel","uri":"http:\/\/www.fcc.gov\/api\/content\/37043"},...]
  • topics[]=[topic id]
    • Search for content based on specific topic IDs. A list of available topics can be found in the Topics section above.
    • Example Request for Broadband Content
    • Example Return
      • [{"count":"623","pages":62,"itemsPerPage":10,"currentPage":0},{"nid":"37071","title":"Open Internet Workshops and Speeches","created":"2011-12-21","changed":"2011-12-21","type":"article","webUrl":"http:\/\/www.fcc.gov\/encyclopedia\/openinternet-workshops-andspeeches","uri":"http:\/\/www.fcc.gov\/api\/content\/37071"},...]
  • title=[title]
  • Example Return
    • [{"count":"1","pages":0,"itemsPerPage":10,"currentPage":0},{"nid":"37071","title":"Open Internet Workshops and Speeches","created":"2011-12-21","changed":"2011-12-21","type":"article","webUrl":"http:\/\/www.fcc.gov\/encyclopedia\/openinternet-workshops-andspeeches","uri":"http:\/\/www.fcc.gov\/api\/content\/37071"}]
  • created_before=[YYYY-MM-DD] (inclusive)
    • Search for content created before the specified date
    • Example Request for content created before December 1, 2011
    • Example Return
      • [{"count":"19174","pages":1917,"itemsPerPage":10,"currentPage":0},{"nid":"36717","title":"FCC Workshops on the Telephone","created":"2011-11-30","changed":"2011-12-01","type":"edoc","webUrl":"http://www.fcc.gov/document/fcc-workshopstelephone","uri":"http://www.fcc.gov/api/content/36717"},...]
  • created_after=[YYYY-MM-DD]
    • Search for content created after the specified date
    • Example Request for content created after December 1, 2011
    • Example Return
      • [{"count":"308","pages":30,"itemsPerPage":10,"currentPage":0},{"nid":"37071","title":"Open Internet Workshops and Speeches","created":"2011-12-21","changed":"2011-12-21","type":"article","webUrl":"http://www.fcc.gov/encyclopedia/openinternet-workshops-andspeeches","uri":"http://www.fcc.gov/api/content/37071"},...]
  • changed_before=[YYYY-MM-DD]
    • Search for content changed before a specified date
    • Example Request for content changed before December 1, 2011
    • Example Return
      • [{"count":"19482","pages":1948,"itemsPerPage":10,"currentPage":0},{"nid":"37071","title":"Open Internet Workshops and Speeches","created":"2011-12-21","changed":"2011-12-21","type":"article","webUrl":"http://www.fcc.gov/encyclopedia/openinternet-workshops-andspeeches","uri":"http://www.fcc.gov/api/content/37071"},...]
  • changed_after=[YYYY-MM-DD]
    • Search for content changed after a specified date
    • Example Request for content changed after December 1, 2011
    • Example Return
      • [{"count":"19482","pages":1948,"itemsPerPage":10,"currentPage":0},{"nid":"37071","title":"Open Internet Workshops and Speeches","created":"2011-12-21","changed":"2011-12-21","type":"article","webUrl":"http://www.fcc.gov/encyclopedia/openinternet-workshops-andspeeches","uri":"http://www.fcc.gov/api/content/37071"},...]
  • limit=[limit]
    • Limit the total number of results shown on each page of results. There can be a maximum number of results returned to the user set by an administrator. Unless this parameter is specified, 10 results will be returned.
    • Example Request with 50 results
    • Example Return
      • [{"count":"19482","pages":389,"itemsPerPage":50,"currentPage":0},{"nid":"37071","title":"Open Internet Workshops and Speeches","created":"2011-12-21","changed":"2011-12-21","type":"article","webUrl":"http://www.fcc.gov/encyclopedia/openinternet-workshops-andspeeches","uri":"http://www.fcc.gov/api/content/37071"},...]
  • page=[page]
    • Results page to return.
    • Example Request for page 1900
    • Example Return
      • [{"count":"19482","pages":1948,"itemsPerPage":10,"currentPage":1900},{"nid":"17687","title":"Spectrum Task Force Poised to Drive the Implementation of the National Broadband Plan's Spectrum Agenda","created":"2010-04-26","changed":"2011-04-05","type":"blog_post","webUrl":"http:\/\/www.fcc.gov\/blog\/spectrumtask-force-poised-drive-implementation-national-broadband-plans-spectrumagenda","uri":"http:\/\/www.fcc.gov\/api\/content\/17687"},...]
Field Queries
  • You can query for any field by using field_[field name]=[value]
Example:
This will return all content where the author’s job title is “Managing Director”
[{"count":"7","pages":0,"itemsPerPage":10,"currentPage":0},{"nid":"37030","title":"Introducing MyFCC Beta","created":"2011-12-20","changed":"2011-12-20","type":"blog_post","webUrl":"http:\/\/www.fcc.gov\/blog\/introducing-myfccbeta","uri":"http:\/\/www.fcc.gov\/api\/content\/37030"},
 
Other Parameters
  • fields=all -- displays all node fields, including body, topics, taxonomy, cck fields etc.
For proceedings, related edocs and comments can be returned with the following parameters:

To get major topics, call http://fcc.gov/api/content.json?major_topics=true

  • major_topics=true
Available Types
The types parameter consists of the following options:
  • edoc (Official Document)
  • event
  • blog_post
  • article (Encyclopedia article)
  • page
  • guide
  • help
  • map
  • report
  • proceeding (Rulemaking)
  • topic
  • video
  • working_paper
 
Gotcha-yas
The first result in any query contains count and page values. The count is how many items match your query, and the page is how many pages exist with your current limit parameter. Pagination starts at 0
 
{
"count":"19174",
"pages":1917,
"itemsPerPage":10,
"currentPage":0
}
… actual node results ...
 
 

close
FCC

You are leaving the FCC website

You are about to leave the FCC website and visit a third-party, non-governmental website that the FCC does not maintain or control. The FCC does not endorse any product or service, and is not responsible for, nor can it guarantee the validity or timeliness of the content on the page you are about to visit. Additionally, the privacy policies of this third-party page may differ from those of the FCC.