FactSet RBICS API

  • SECTIONS
  • Overview
  • API Definition
  • API Documentation
  • SDK Libraries
  • Notebooks
  • Code Snippet
  • Changelog
Overview

FactSet Revere Business Industry Classification System (RBICS) API

The FactSet Revere Business Industry Classification System (RBICS) API offers a single-sector mapping of over 50,000 of the most liquid and publicly-traded companies based on their primary lines of business. It uses revenues as the key factor in determining a company’s primary line of business by mapping a company to the lowest-level sector from which it derives 50% or more of its revenues. Backed by over two decades of expertise, it provides unmatched insights into the evolution of industries and corporate trajectories.

Key Features

  • Historical Expertise: Over 20 years of detailed data, capturing U.S. information since 2003 and covering the international markets from 2011.
  • Comprehensive Coverage: Includes large-cap to small-cap companies across all market sectors, both in the U.S. and internationally.
  • Detailed Classification: The RBICS 14x6 matrix covers over 1,800 sector groups using a bottom-up classification approach for precision.

Endpoint Coverage

  • /factset-rbics/v1/entity-focus: Fetch the 6-level classification taxonomy for a list of IDs and a date using GET or POST, with coverage starting from 2003 (U.S.) and 2011 (Europe and Asia).
  • /factset-rbics/v1/structure: Retrieve the full RBICS Taxonomy Structure, including IDs, names, and effective periods, via GET or POST. This encompasses 12 anchor industries, 2 specialty industries, and over 1,800 sector groups in a 14x6 matrix.

Use Cases

  • Accurate Classification: Access detailed classification across 1,800+ sector groups.
  • Enhanced Investment Strategies: Refine portfolio construction, perform thorough competitor analysis, and identify complex industry relationships.

How to Programmatically Download API Specification File

Please use the below link to download the FactSet RBICS API Specification file in .yaml. You must be authorized for this API to extract. This specification can then be used for Codegen to create your own SDKs. You can also access by selecting the "Download Spec" button to the right of the version below.

https://api.factset.com/content/TBD/v1/spec/swagger.yaml

Rate limit: 10 requests per second

API Definition
API Documentation
SDK Libraries
Notebooks
Getting Started - Juypter Notebook SDK
Code Snippet
Sample code to retrieve the RBICS industry classification using FactSet RBICS API
# Imports
import pandas as pd

# FDS Packages
import fds.sdk.FactSetRBICS # To install, please use "pip install fds.sdk.utils fds.sdk.FactSetRBICS==0.21.8"
from fds.sdk.FactSetRBICS.api import entity_focus_api
from fds.sdk.FactSetRBICS.models import *
from fds.sdk.utils.authentication import ConfidentialClient

# Authentication using OAuth
configuration = fds.sdk.FactSetRBICS.Configuration(
    fds_oauth_client=ConfidentialClient('<PATH_TO_CONFIG_FILE>') # Path to config file from OAuth registration
)

# Get Entity-focus Data
with fds.sdk.FactSetRBICS.ApiClient(configuration) as api_client:
    # Create Instance
    api_instance = entity_focus_api.EntityFocusApi(api_client)

    # Request Object to Define Parameters
    entity_focus_request = EntityFocusRequest(
        ids=Ids(["FDS-US","0FPWZZ-E","TSLA-US"]),
        date="2020-09-30",
        levels=Levels([1,3,6]),
        include_names=True,
    )

    # Send Request
    api_response = api_instance.get_rbics_entity_focus_for_list(entity_focus_request)

    # Convert to Pandas Dataframe
    results = pd.DataFrame(api_response.to_dict()['data'])
    print(results)

Changelog

1.1.0

Summary

Added new /structure endpoint which will allow users to fetch the full RBICS Taxonomy Structure Ids, Names, and effective periods.

Functionality Additions

New Endpoint:

  • /structure: Understand the full RBICS Taxonomy Structure through time to help organize your analysis or facilitate the use of RBICS in application development. Designed to overcome disparate and non-standardized company disclosures, the RBICS taxonomy is a normalized global industry classification consisting of a fourteen-by-six matrix. There are twelve economies with two specialty sectors, each with six incremental detailed layers, resulting in over 1,600 sector groups.