Skip to main content

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.5.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.5.0
File Size Uploaded
secedgar-0.5.0.tar.gz 1.1 MB Details

Built distributions (wheels)

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

Total release size: 1.4 MB

Release files / secedgar-0.5.0.tar.gz

Download URL secedgar-0.5.0.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
e56e5f5c851519ae563d50cc88d5bcd26b635353d5a9cf60d785593201d33d5f
BLAKE2b-256 checksum
How to use checksums
b6cf3b40daff20bb01d812ed864226738fe8aa3f3ce306128fe2c313221823c1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.0

Release files / secedgar-0.5.0-py3.11.egg

Download URL secedgar-0.5.0-py3.11.egg
Size 194.6 kB
Tags Egg
SHA-256 checksum
How to use checksums
e9050faf57ad31cfaa365fd3a2da166002d2eafcf647ac426776305210b2a067
BLAKE2b-256 checksum
How to use checksums
d31aeccba828807e06a769b78ccb9ebde3c87032c25e52deba59611ff4c4c826
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.0

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

Download URL secedgar-0.5.0-py3-none-any.whl
Size 67.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8447ecea53c11bc3fe6920304b8392d96bfda87688ed0449e63e8f6f85e5d373
BLAKE2b-256 checksum
How to use checksums
1926fb65e99c00113a927db436ff30c9c28c0cdac276af5698a777fde501ac79
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.0
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