This community helps developers, analysts, and business intelligence professionals connect and use the XBRL API, Public Filings Database, Google Sheet resources and other tools more effectively.

Start using as-filed data


The Google Add-on is the easiest way to get started working with data from the Database of Public Filings via the XBRL API . You can also get OAuth2 access to the data to use in additional resources below or your applications.

Data Community Resources:

Watch an introductory webinar replay about retrieving data with the XBRL API

  1. Member-contributed API Templates and Tools
    Everyone can use these resources. XBRL US Members earn discounts for contributing to the XBRL API Template/Tools library. Got an idea? Email info@xbrl.us so we can discuss it with you (we may have helpful tips, too).

    Interested in getting access to all the data? While anyone can use these templates and tools to query the Database of Public Filings, non-members will only return a sample of what’s available – consider XBRL US Membership options for yourself or your team.

Google Sheet

 

Balance Sheet Compare – SEC Filers contributed by Power User Peter Guldberg
This template features a customizable Taxonomy Map that lets analysts compare financials for US GAAP and IFRS filers.

Google Sheet

 

Classroom Activity from XBRL US
Designed to introduce a group of users to the XBRL API, one tab has ‘warm up’ queries that ensure everyone is connected to the API, and the other tab is a stand-alone exercise with answer key to understand basic parameter/formula manipulation to achieve desired results. XBRL US Academic Members – contact us for help with prep and/or rollout.

Google Sheet

 

Statement & Disclosure Explorer from XBRL US
Use a simple ‘wizard’ interface to select and retrieve face financial details for any 10-K or 10-Q XBRL filing; drill into specific statements or disclosures, or override the select mechanism to get all filing details reported in XBRL.

Google Sheet

 

Margin Comparison / Time Series from XBRL US
This template queries common Revenue and Income/Loss elements for up to 10 tickers and displays pivot tables for high-level graphic comparison. The Margin Time Series focuses on the ‘default’ ticker from the Margin Comparison, with override cells that can quickly change company and/or element screen.

Google Sheet

 

XBRL Spreadsheet from XBRL US
A Google Sheet with several basic queries and a simple Balance Sheet Comparison for companies filing with US GAAP Taxonomies

API Template

Excel Power Query Template (.zip download) contributed by Power User Jim Truscott
This template uses Microsoft’s Power Query functionality to retrieve data (Excel 2013 or later on a Windows PC). The setup requires OAuth2 access after downloading and extracting the .xlsx file from the .zip. Watch an introductory set-up video for the Excel spreadsheet from the developer.

API Tool

 

XBRLUSCall for PHP (v0.1) from XBRL US
Download the .zip from GitHub and use XBRLUSCall to simplify the task of creating programatic requests in PHP to the XBRL US API. With your OAuth2 access, this class:

  • Handles requesting and managing OAuth tokens (access_token and refresh_token)
  • Handles multiple calls (pagination) to the API to obtain the full results of the data set rather than the per-request limit
  • Automatically handles potential errors
  • Certain functions can be overridden to allow token persistence between initializations
API Tool

 

Jupyter Notebook – R – from XBRL US
Use this sample open-source, web-based front-end with your OAuth2 access as a starting point for creating an interactive, versioned, distributable resource for your research using R programming language.

API Tool

 

Jupyter Notebook – IPython – from XBRL US
Use this sample open-source, web-based front-end with your OAuth2 access as a starting point for creating an interactive, versioned, distributable resource for your research using interactive Python programming language.

API Tool

 

Sample Queries (Insomnia workspace) from XBRL US
This set of XBRL API queries is designed to be loaded from Insomnia software using your OAuth2 access.

  1. Discussion forum

    Home › Forums › Home › Using Data › Search

    All visitors can exchange ideas and pose questions to XBRL data users in a community forum. Browse the latest topics below or use the link or search box above to get answers on other topics.

    Home › Forums › Home › Using Data › The XBRL API

    Viewing 15 topics - 16 through 30 (of 68 total)
    1 2 3 … 5
    Viewing 15 topics - 16 through 30 (of 68 total)
    1 2 3 … 5
    • You must be logged in to create new topics.
  2. Periodic Member-only web meetings
    Engage in an open forum to learn about new functionality and techniques for using XBRL API, get questions answered, and let members preview XBRL Spreadsheets in development and other applications. The list of upcoming and prior meeting replays is at the right-side of this page.

Comment

Using Data

XBRL API Resources

Who's using this free data?

API Use 2020 || API Use 2019
API Use 2018

Join XBRL US

Using the XBRL API with the Public Filings Database

Unless otherwise agreed to in writing, any and all use of the XBRL API to authenticate and retrieve data from the XBRL US Database of Public Filings implies user consent and agreement with the XBRL US API Agreement. If you are unable to agree to these terms, do not use the XBRL API.



Your account needs to be provisioned before you can login and generate client ID/secret pairs.

Login or register for a free account.

XBRL Data Events