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

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

Built distributions (wheels)

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

Total release size: 1.3 MB

Release files / secedgar-0.4.0a3.tar.gz

Download URL secedgar-0.4.0a3.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
76d99350a2c52289200633b59fe83346c3f3fc8ef8d537c3be181277a9cc97e6
BLAKE2b-256 checksum
How to use checksums
c721aec57ff45bde3f182b12473b874c27e3839b9f14905e32b903786a9086aa
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.0a3-py3.10.egg

Download URL secedgar-0.4.0a3-py3.10.egg
Size 142.5 kB
Tags Egg
SHA-256 checksum
How to use checksums
0a6d928ecb7dd9fa5125712aff234c9f4fe2f012b7b69f97f578988deb075455
BLAKE2b-256 checksum
How to use checksums
d8581595eac877b63863b9f1d181f5e06f9ac6661ea5b9236cd15c97eac381af
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.0a3-py3-none-any.whl

Download URL secedgar-0.4.0a3-py3-none-any.whl
Size 61.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e55ca7dddc224fcfaf60e6b74ce365ef0c4c67cd4015f871e3aa5f8ed584238b
BLAKE2b-256 checksum
How to use checksums
5c732b4145683d053af1fd360f22ec1648ebe5e40e54868b3771e6511f7176f1
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