sec edgar downloader 📈

SEC EDGAR DownloaderRelease 4.3.0

Jad Chaar

Dec 24, 2021

CONTENTS

1 Quick Start 31.1 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.2 Basic Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.3 Advanced Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 Supported SEC Filing Types 5

3 Contributing 17

4 Documentation 19

5 API Guide 215.1 Downloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Python Module Index 23

Index 25

i

SEC EDGAR Downloader , Release 4.3.0

sec-edgar-downloader is a 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 ifyou cannot find an appropriate ticker.

CONTENTS 1

https://github.com/jadchaar/sec-edgar-downloader/actions?query=branch%3Amaster+workflow%3Atests

https://codecov.io/gh/jadchaar/sec-edgar-downloader

https://python.org/pypi/sec-edgar-downloader



https://en.wikipedia.org/wiki/SEC_filing

https://www.sec.gov/edgar/searchedgar/companysearch.html

https://en.wikipedia.org/wiki/Ticker_symbol

https://en.wikipedia.org/wiki/Central_Index_Key

https://www.sec.gov/edgar/searchedgar/cik.htm


2 CONTENTS

CHAPTER

ONE

QUICK START

1.1 Installation

Install and update this package using pip:

$ pip install -U sec-edgar-downloader

1.2 Basic Usage

from sec_edgar_downloader import Downloader

# Initialize a downloader instance. If no argument is passed# to the constructor, the package will download filings to# the current working directory.dl = Downloader("/path/to/valid/save/location")

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

# Get all 8-K filings for Apple, including filing amends (8-K/A)dl.get("8-K", "AAPL", include_amends=True)

# Get all 8-K filings for Apple after January 1, 2017 and before March 25, 2017# Note: after and before strings must be in the form "YYYY-MM-DD"dl.get("8-K", "AAPL", after="2017-01-01", before="2017-03-25")

# Get the five most recent 8-K filings for Appledl.get("8-K", "AAPL", amount=5)

# Get all 10-K filings for Microsoftdl.get("10-K", "MSFT")

# Get the latest 10-K filing for Microsoftdl.get("10-K", "MSFT", amount=1)

# Get all 10-Q filings for Visadl.get("10-Q", "V")

(continues on next page)

3

https://pip.pypa.io/en/stable/quickstart/


(continued from previous page)

# Get all 13F-NT filings for the Vanguard Groupdl.get("13F-NT", "0000102909")

# Get all 13F-HR filings for the Vanguard Groupdl.get("13F-HR", "0000102909")

# Get all SC 13G filings for Appledl.get("SC 13G", "AAPL")

# Get all SD filings for Appledl.get("SD", "AAPL")

1.3 Advanced Usage

from sec_edgar_downloader import Downloader

# Download filings to the current working directorydl = Downloader()

# Get all Apple proxy statements that contain the term "antitrust"dl.get("DEF 14A", "AAPL", query="antitrust")

# Get all 10-K filings for Microsoft without the filing detailsdl.get("10-K", "MSFT", download_details=False)

# Get the latest supported filings, if available, for Applefor filing_type in dl.supported_filings:

dl.get(filing_type, "AAPL", amount=1)

# Get the latest supported filings, if available, for a# specified list of tickers and CIKsequity_ids = ["AAPL", "MSFT", "0000102909", "V", "FB"]for equity_id in equity_ids:

for filing_type in dl.supported_filings:dl.get(filing_type, equity_id, amount=1)

4 Chapter 1. Quick Start

CHAPTER

TWO

SUPPORTED SEC FILING TYPES

This package supports downloading all SEC filing types (6-K, 8-K, 10-K, DEF 14A, S-1, and many others). Youcan learn more about the different SEC filing types here). Below is an exhaustive list of all filings types that can bedownloaded by this package:

• 1

• 1-A

• 1-A POS

• 1-A-W

• 1-E

• 1-E AD

• 1-K

• 1-SA

• 1-U

• 1-Z

• 1-Z-W

• 10-12B

• 10-12G

• 10-D

• 10-K

• 10-KT

• 10-Q

• 10-QT

• 11-K

• 11-KT

• 13F-HR

• 13F-NT

• 13FCONP

• 144

• 15-12B

5

https://www.investopedia.com/articles/fundamental-analysis/08/sec-forms.asp


• 15-12G

• 15-15D

• 15F-12B

• 15F-12G

• 15F-15D

• 18-12B

• 18-K

• 19B-4E

• 2-A

• 2-AF

• 2-E

• 20-F

• 20FR12B

• 20FR12G

• 24F-2NT

• 25

• 25-NSE

• 253G1

• 253G2

• 253G3

• 253G4

• 3

• 305B2

• 34-12H

• 4

• 40-17F1

• 40-17F2

• 40-17G

• 40-17GCS

• 40-202A

• 40-203A

• 40-206A

• 40-24B2

• 40-33

• 40-6B

• 40-8B25

6 Chapter 2. Supported SEC Filing Types


• 40-8F-2

• 40-APP

• 40-F

• 40-OIP

• 40FR12B

• 40FR12G

• 424A

• 424B1

• 424B2

• 424B3

• 424B4

• 424B5

• 424B7

• 424B8

• 424H

• 425

• 485APOS

• 485BPOS

• 485BXT

• 486APOS

• 486BPOS

• 486BXT

• 487

• 497

• 497AD

• 497H2

• 497J

• 497K

• 5

• 6-K

• 6B NTC

• 6B ORDR

• 8-A12B

• 8-A12G

• 8-K

• 8-K12B

7


• 8-K12G3

• 8-K15D5

• 8-M

• 8F-2 NTC

• 8F-2 ORDR

• 9-M

• ABS-15G

• ABS-EE

• ADN-MTL

• ADV-E

• ADV-H-C

• ADV-H-T

• ADV-NR

• ANNLRPT

• APP NTC

• APP ORDR

• APP WD

• APP WDG

• ARS

• ATS-N

• ATS-N-C

• ATS-N/UA

• AW

• AW WD

• C

• C-AR

• C-AR-W

• C-TR

• C-TR-W

• C-U

• C-U-W

• C-W

• CB

• CERT

• CERTARCA

• CERTBATS



• CERTCBO

• CERTNAS

• CERTNYS

• CERTPAC

• CFPORTAL

• CFPORTAL-W

• CORRESP

• CT ORDER

• D

• DEF 14A

• DEF 14C

• DEFA14A

• DEFA14C

• DEFC14A

• DEFC14C

• DEFM14A

• DEFM14C

• DEFN14A

• DEFR14A

• DEFR14C

• DEL AM

• DFAN14A

• DFRN14A

• DOS

• DOSLTR

• DRS

• DRSLTR

• DSTRBRPT

• EFFECT

• F-1

• F-10

• F-10EF

• F-10POS

• F-1MEF

• F-3

• F-3ASR

9


• F-3D

• F-3DPOS

• F-3MEF

• F-4

• F-4 POS

• F-4MEF

• F-6

• F-6 POS

• F-6EF

• F-7

• F-7 POS

• F-8

• F-8 POS

• F-80

• F-80POS

• F-9

• F-9 POS

• F-N

• F-X

• FOCUSN

• FWP

• G-405

• G-405N

• G-FIN

• G-FINW

• IRANNOTICE

• MA

• MA-A

• MA-I

• MA-W

• MSD

• MSDCO

• MSDW

• N-1

• N-14

• N-14 8C



• N-14MEF

• N-18F1

• N-1A

• N-2

• N-23C-2

• N-23C3A

• N-23C3B

• N-23C3C

• N-2MEF

• N-30B-2

• N-30D

• N-4

• N-5

• N-54A

• N-54C

• N-6

• N-6F

• N-8A

• N-8B-2

• N-8F

• N-8F NTC

• N-8F ORDR

• N-CEN

• N-CR

• N-CSR

• N-CSRS

• N-MFP

• N-MFP1

• N-MFP2

• N-PX

• N-Q

• NO ACT

• NPORT-EX

• NPORT-NP

• NPORT-P

• NRSRO-CE

11


• NRSRO-UPD

• NSAR-A

• NSAR-AT

• NSAR-B

• NSAR-BT

• NSAR-U

• NT 10-D

• NT 10-K

• NT 10-Q

• NT 11-K

• NT 20-F

• NT N-CEN

• NT N-MFP

• NT N-MFP1

• NT N-MFP2

• NT NPORT-EX

• NT NPORT-P

• NT-NCEN

• NT-NCSR

• NT-NSAR

• NTFNCEN

• NTFNCSR

• NTFNSAR

• NTN 10D

• NTN 10K

• NTN 10Q

• NTN 20F

• OIP NTC

• OIP ORDR

• POS 8C

• POS AM

• POS AMI

• POS EX

• POS462B

• POS462C

• POSASR



• PRE 14A

• PRE 14C

• PREC14A

• PREC14C

• PREM14A

• PREM14C

• PREN14A

• PRER14A

• PRER14C

• PRRN14A

• PX14A6G

• PX14A6N

• QRTLYRPT

• QUALIF

• REG-NR

• REVOKED

• RW

• RW WD

• S-1

• S-11

• S-11MEF

• S-1MEF

• S-20

• S-3

• S-3ASR

• S-3D

• S-3DPOS

• S-3MEF

• S-4

• S-4 POS

• S-4EF

• S-4MEF

• S-6

• S-8

• S-8 POS

• S-B

13


• S-BMEF

• SC 13D

• SC 13E1

• SC 13E3

• SC 13G

• SC 14D9

• SC 14F1

• SC 14N

• SC TO-C

• SC TO-I

• SC TO-T

• SC13E4F

• SC14D1F

• SC14D9C

• SC14D9F

• SD

• SDR

• SE

• SEC ACTION

• SEC STAFF ACTION

• SEC STAFF LETTER

• SF-1

• SF-3

• SL

• SP 15D2

• STOP ORDER

• SUPPL

• T-3

• TA-1

• TA-2

• TA-W

• TACO

• TH

• TTW

• UNDER

• UPLOAD



• WDL-REQ

• X-17A-5

15

CHAPTER

THREE

CONTRIBUTING

If you encounter a bug or would like to see a new company filing or feature added to sec-edgar-downloader, pleasefile an issue or submit a pull request.

17

https://github.com/jadchaar/sec-edgar-downloader/issues

https://help.github.com/en/articles/creating-a-pull-request


18 Chapter 3. Contributing

CHAPTER

FOUR

DOCUMENTATION

For full documentation, please visit sec-edgar-downloader.readthedocs.io.

19

https://sec-edgar-downloader.readthedocs.io


20 Chapter 4. Documentation

CHAPTER

FIVE

API GUIDE

5.1 Downloader

Provides a Downloader class for downloading SEC EDGAR filings.

class sec_edgar_downloader.Downloader.Downloader(download_folder=None)A Downloader object.

Parameters download_folder (Union[str, Path, None]) – relative or absolute path to downloadlocation. Defaults to the current working directory.

Usage:

>>> from sec_edgar_downloader import Downloader

# Download to current working directory>>> dl = Downloader()

# Download to relative or absolute path>>> dl = Downloader("/path/to/valid/save/location")

get(filing, ticker_or_cik, *, amount=None, after=None, before=None, include_amends=False,download_details=True, query='')Download filings and save them to disk.

Parameters

• filing (str) – filing type to download (e.g. 8-K).

• ticker_or_cik (str) – ticker or CIK to download filings for.

• amount (Optional[int]) – number of filings to download. Defaults to all available filings.

• after (Optional[str]) – date of form YYYY-MM-DD after which to download filings.Defaults to 2000-01-01, the earliest date supported by EDGAR full text search.

• before (Optional[str]) – date of form YYYY-MM-DD before which to download fil-ings. Defaults to today.

• include_amends (bool) – denotes whether or not to include filing amends (e.g. 8-K/A).Defaults to False.

• download_details (bool) – denotes whether or not to download human-readable andeasily parseable filing detail documents (e.g. form 4 XML, 8-K HTML). Defaults to True.

• query (str) – keyword to search for in filing documents.

Return type int

21


Returns number of filings downloaded.

Usage:

>>> from sec_edgar_downloader import Downloader>>> dl = Downloader()

# Get all 8-K filings for Apple>>> dl.get("8-K", "AAPL")

# Get all 8-K filings for Apple, including filing amends (8-K/A)>>> dl.get("8-K", "AAPL", include_amends=True)

# Get all 8-K filings for Apple after January 1, 2017 and before March 25, 2017>>> dl.get("8-K", "AAPL", after="2017-01-01", before="2017-03-25")

# Get the five most recent 10-K filings for Apple>>> dl.get("10-K", "AAPL", amount=5)

# Get all 10-K filings for Apple, excluding the filing detail documents>>> dl.get("10-K", "AAPL", amount=1, download_details=False)

# Get all Apple proxy statements that contain the term "antitrust">>> dl.get("DEF 14A", "AAPL", query="antitrust")

# Get all 10-Q filings for Visa>>> dl.get("10-Q", "V")

# Get all 13F-NT filings for the Vanguard Group>>> dl.get("13F-NT", "0000102909")

# Get all 13F-HR filings for the Vanguard Group>>> dl.get("13F-HR", "0000102909")

# Get all SC 13G filings for Apple>>> dl.get("SC 13G", "AAPL")

# Get all SD filings for Apple>>> dl.get("SD", "AAPL")

22 Chapter 5. API Guide

PYTHON MODULE INDEX

ssec_edgar_downloader.Downloader, 21

23


24 Python Module Index

INDEX

DDownloader (class in sec_edgar_downloader.Downloader),

21

Gget() (sec_edgar_downloader.Downloader.Downloader

method), 21

Mmodulesec_edgar_downloader.Downloader, 21

Ssec_edgar_downloader.Downloader

module, 21

25

sec edgar downloader 📈

Documents