Skip to main content
Pre-release

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

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.0a1

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

Built distributions (wheels)

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

Total release size: 1.3 MB

Release files / secedgar-0.4.0a1.tar.gz

Download URL secedgar-0.4.0a1.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
5d8d5010641ef84759ef476afaa55f3c1d2ea700badf2bb34edfdca97674b40f
BLAKE2b-256 checksum
How to use checksums
686e281d2ac0dab2327505a29ffdacbe9274e954789da31f06171f47a909ef5f
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.0a1-py3.9.egg

Download URL secedgar-0.4.0a1-py3.9.egg
Size 129.3 kB
Tags Egg
SHA-256 checksum
How to use checksums
4f867ffb9cad61495235a96eae280e420f74ccccdfbdd1a31333b5207a1fd70e
BLAKE2b-256 checksum
How to use checksums
fb63749e063908be47da5a9658129f9c381020e072c9de4672be39b46d9f215a
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.0a1-py3-none-any.whl

Download URL secedgar-0.4.0a1-py3-none-any.whl
Size 56.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
394ef4b83ddfd498797305a6187e4107a84466fa2f247e8fbbf2b8468ee7f96b
BLAKE2b-256 checksum
How to use checksums
18ce0cdde00c156567016159344fbbed2768ce871f5b165f88bf2a2e7afaedb7
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