secedgar

Getting filings of various companies at once is really a pain, but SEC-Edgar does that for you. You can download all of a company’s periodic reports, filings and forms from the EDGAR database with a single command.

Installation

You can install the package using pip:

$ pip install secedgar

You can clone the project:

$ git clone https://github.com/sec-edgar/sec-edgar.git
$ cd sec-edgar
$ python setup.py install

Running

If you are using Jupyter Notebook, you’ll need to install and configure nest-asyncio:

pip install nest-asyncio

Then add the following code at the start of your notebook:

import nest_asyncio
nest_asyncio.apply()

Company Filings

Single Company

from secedgar import filings, FilingType

# 10Q filings for Apple (ticker "aapl")
my_filings = filings(cik_lookup="aapl",
                     filing_type=FilingType.FILING_10Q,
                     user_agent="Your name (your email)")
my_filings.save('/path/to/dir')

Multiple Companies

from secedgar import filings, FilingType

# 10Q filings for Apple and Facebook (tickers "aapl" and "fb")
my_filings = filings(cik_lookup=["aapl", "fb"],
                     filing_type=FilingType.FILING_10Q,
                     user_agent="Your name (your email)")
my_filings.save('/path/to/dir')

Daily Filings

from secedgar import filings
from datetime import date

daily_filings = filings(start_date=date(2021, 6, 30),
                        user_agent="Your name (your email)")
daily_urls = daily_filings.get_urls()

Supported Methods

Currently this crawler supports many different filing types. To see the full list, please refer to the docs. If you don’t see a filing type you would like to be supported, please create an issue on GitHub.

Documentation

To learn more about the APIs and latest changes in the project, read the official documentation.

Release files for secedgar 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for secedgar 0.6.0
File	Size	Uploaded
secedgar-0.6.0.tar.gz	1.1 MB	May 9, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for secedgar 0.6.0
File	Interpreter	ABI	Platform	Reset
secedgar-0.6.0-py3-none-any.whl 62.6 kB May 9, 2025	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / secedgar-0.6.0.tar.gz

Download URL	secedgar-0.6.0.tar.gz
Size	1.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`c5efbe03a128995a6c69bd53bacbc8ac574c2df890898b0187591209b9eaea0d`
BLAKE2b-256 checksum How to use checksums	`caed0629ff4cfa94489058536abbe44fad5d82183c9ec0421663d3a6706eed2e`
Upload date	May 9, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.3`

Release files / secedgar-0.6.0-py3-none-any.whl

Download URL	secedgar-0.6.0-py3-none-any.whl
Size	62.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`14f6735923aaddaab5e933394bb4251e61836bfac12fa659edb85f86e8990e5c`
BLAKE2b-256 checksum How to use checksums	`846797f105c4f98bb89d42fdc822d5032d45895874bd20208a368a9f40bc6a84`
Upload date	May 9, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.3`