secedgar

Pre-release

This release is a pre-release and may not be stable for production use.

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

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.

Metadata

Release files for secedgar 0.6.0a0

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.0a0
File	Size	Uploaded
secedgar-0.6.0a0.tar.gz	1.1 MB	Feb 22, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for secedgar 0.6.0a0
File	Interpreter	ABI	Platform	Reset
secedgar-0.6.0a0-py3-none-any.whl 62.5 kB Feb 22, 2025	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / secedgar-0.6.0a0.tar.gz

Download URL	secedgar-0.6.0a0.tar.gz
Size	1.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`df027639768e028b35666082b0ed7bbb4e4f47104b3379732097b52ddf54c12a`
BLAKE2b-256 checksum How to use checksums	`ddbfd2f8776a715e232886cf887a4a0532cc8960eec2b8fb84a6ede984bdcaf8`
Upload date	Feb 22, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.2`

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

Download URL	secedgar-0.6.0a0-py3-none-any.whl
Size	62.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`42c38c0baf36a8800d1f18e80ef56228e2d6d910c5b29ea7209e411357242b32`
BLAKE2b-256 checksum How to use checksums	`82baba0542700fb7e8a9ed7109a8911498dbf4b6f42a01a0e52976c6fb8ecaa9`
Upload date	Feb 22, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.2`