Skip to main content
Pre-release

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

sec-edgar

Tests Status Docs Status

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

OR

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.4.0a2

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.4.0a2
File Size Uploaded
secedgar-0.4.0a2.tar.gz 1.1 MB Details

Built distributions (wheels)

Table of built distributions (wheels) for secedgar 0.4.0a2
File Interpreter ABI Platform
secedgar-0.4.0a2-py3.9.egg Legacy Egg format - - Details
secedgar-0.4.0a2-py3-none-any.whl Python 3 none any Details

Total release size: 1.3 MB

Release files / secedgar-0.4.0a2.tar.gz

Download URL secedgar-0.4.0a2.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
97d7c55ac4bfc4fe11c3074cf1969dfefddb38223c66b3f48203491bb904f65c
BLAKE2b-256 checksum
How to use checksums
0fecfce3daacb53a1e811dee7453d35ceaefbd93092c264a7bbc7034e8af0864
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.9.6

Release files / secedgar-0.4.0a2-py3.9.egg

Download URL secedgar-0.4.0a2-py3.9.egg
Size 129.6 kB
Tags Egg
SHA-256 checksum
How to use checksums
d635e57d305ff3579c7e6717357fec184b76b9d2043e6a89ce7ff7a6bb1fd08f
BLAKE2b-256 checksum
How to use checksums
b8e8100d4658356aff394b59f4a29f61b2c30770af391a915459a3e58bd948c7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.9.6

Release files / secedgar-0.4.0a2-py3-none-any.whl

Download URL secedgar-0.4.0a2-py3-none-any.whl
Size 56.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
377d52808b738e6a36006843647ad50f80b76118bce9e23629d5a45384ee550d
BLAKE2b-256 checksum
How to use checksums
0120e7d6fa2778ec176a8b4c15bf260b16deed61934a77ca0f025ac7c0ce63ac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.9.6
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page