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.1

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.1
File Size Uploaded
secedgar-0.4.1.tar.gz 1.1 MB Details

Built distributions (wheels)

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

Total release size: 1.4 MB

Release files / secedgar-0.4.1.tar.gz

Download URL secedgar-0.4.1.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
e9d1fa39f8728e70af4fe0f6725020533040fc64e478d8a35810592f23a6d0a7
BLAKE2b-256 checksum
How to use checksums
a8970a9e367224a8e243371735bb20d8278ae874b57a575cd7103e559bcf8722
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.4.1-py3.11.egg

Download URL secedgar-0.4.1-py3.11.egg
Size 183.8 kB
Tags Egg
SHA-256 checksum
How to use checksums
99d4ceba30731db78d7cc6461f7424cc6028e4ecdf91f13e8b9ddc01179ade36
BLAKE2b-256 checksum
How to use checksums
45291f5d874106d0107edde52a23a35831dfb8876ff9b8b0e0b04d33d24042c3
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.4.1-py3-none-any.whl

Download URL secedgar-0.4.1-py3-none-any.whl
Size 63.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
82db6c033057a982c94adcb85a98ba69c368bd66d6360e62e7f2530109b942a9
BLAKE2b-256 checksum
How to use checksums
156be8a70dcc7eb182f076a865f731350d5c46012860280185da2459c9e7a0b8
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