Skip to main content

SEC-Edgar implements a basic crawler for downloading

Project description

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.


You can install the package using pip:

$ pip install secedgar


You can clone the project:

$ git clone
$ cd sec-edgar
$ python install


Company Filings

Single Company

from secedgar import filings, FilingType

# 10Q filings for Apple (ticker "aapl")
my_filings = filings(cik_lookup="aapl",
                     user_agent="Your name (your email)")'/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"],
                     user_agent="Your name (your email)")'/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.


To learn more about the APIs and latest changes in the project, read the official documentation.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

secedgar-0.5.0.tar.gz (1.1 MB view hashes)

Uploaded source

Built Distributions

secedgar-0.5.0-py3.11.egg (194.6 kB view hashes)

Uploaded 0 5 0

secedgar-0.5.0-py3-none-any.whl (67.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page