Skip to main content

Python package for downloading company filings (8-K, 10-K, 10-Q, 13F-NT, 13F-HR, SC 13G, SD)from the SEC EDGAR database.

Project description

sec-edgar-downloader

Build Status codecov image image image

Python package for downloading company filings from the SEC EDGAR database. Searches can be conducted either by stock ticker or Central Index Key (CIK). You can use the SEC CIK lookup tool if you cannot find an appropriate ticker. Supported company filings: 8-K, 10-K, 10-Q, 13F-NT, 13F-HR, SC 13G, SD. Learn more about the different types of SEC filings here.

Installation

Install and update this package using pip:

pip install -U sec-edgar-downloader

Example usage

from sec_edgar_downloader import Downloader

# Initialize a downloader instance.
# If no argument is passed to the constructor, the package
# will attempt to locate the user's downloads folder.
dl = Downloader("/path/to/valid/save/location")

# Get all 8-K filings for Apple (ticker: AAPL)
dl.get_8k_filings("AAPL")

# Get the past 5 8-K filings for Apple
dl.get_8k_filings("AAPL", 5)

# Get all 10-K filings for Microsoft (ticker: MSFT)
dl.get_10k_filings("MSFT")

# Get the latest 10-K filing for Microsoft
dl.get_10k_filings("MSFT", 1)

# Get all 10-Q filings for Visa (ticker: V)
dl.get_10q_filings("V")

# Get all 13F-NT filings for Vanguard Group (CIK: 0000102909)
dl.get_13f_nt_filings("0000102909")

# Get all 13F-HR filings for Vanguard Group
dl.get_13f_hr_filings("0000102909")

# Get all SC 13G filings for Apple
dl.get_sc_13g_filings("AAPL")

# Get all SD filings for Apple
dl.get_sd_filings("AAPL")

# Get all the latest filings (8-K, 10-K, 10-Q, 13F, SC 13G, SD), if available, for Apple
dl.get_all_available_filings("AAPL", 1)

# Get all the latest filings (8-K, 10-K, 10-Q, 13F, SC 13G, SD), if available,
# for a specified list of tickers and CIKs
identifiers = ["AAPL", "MSFT", "0000102909", "V", "FB"]
for id in identifiers:
    dl.get_all_available_filings(id, 1)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sec-edgar-downloader-2.0.1.tar.gz (5.0 kB view hashes)

Uploaded Source

Built Distribution

sec_edgar_downloader-2.0.1-py3-none-any.whl (6.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page