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

Built distributions (wheels)

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

Total release size: 1.3 MB

Release files / secedgar-0.4.0.tar.gz

Download URL secedgar-0.4.0.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
ce09bdfd4f93f97cced1b9773e01b21864f54a7abccc0787942038cdb9ad8e95
BLAKE2b-256 checksum
How to use checksums
ce29ce313acc39a62f79c4ab243647c68f966447fefabcb6bcbc98b97003fbb4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.0 CPython/3.10.4

Release files / secedgar-0.4.0-py3.10.egg

Download URL secedgar-0.4.0-py3.10.egg
Size 142.5 kB
Tags Egg
SHA-256 checksum
How to use checksums
11d89e939fce2e1ee87a73323466463093d0870409b444e823a017a1c667fcda
BLAKE2b-256 checksum
How to use checksums
0a79bb50f1c7a5d9b3557b28b4e3cae8ec9c49d8e8e7b82f63fc2d77674df72a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.0 CPython/3.10.4

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

Download URL secedgar-0.4.0-py3-none-any.whl
Size 61.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
176e1d5f60cd9cc14c14aabc668991f89cfc2e10525e193617170bfe3c40756f
BLAKE2b-256 checksum
How to use checksums
7429f2bce7fdbba37a1e2b5be4c9eea8d119b64ac60eddc0152289a13ade2b37
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.0 CPython/3.10.4
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