---
id: sec-edgar-downloader
version: "5.1.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# sec-edgar-downloader — Download SEC filings from the EDGAR database using Python

License: permissive · Maintenance: active · Downloads: 210.7K/mo

## What it is and what it does

sec-edgar-downloader is a Python library that automates retrieval of SEC company filings from the EDGAR database. It wraps the SEC's public filing search with a simple API, letting you fetch filings by stock ticker or Central Index Key (CIK) and filter by filing type, date range, and recency. The package handles the user-agent requirements mandated by SEC EDGAR's programmatic access policy.

You provide a company name and email address (used to form a compliant user-agent), then call get() with a filing type (8-K, 10-K, 10-Q, and many others) and a company identifier. The library downloads filings to a local directory, with optional filtering for amended filings, date ranges, and result limits. It depends on requests for HTTP access and pyrate-limiter to respect rate limits.

Use it for:

- Bulk download 10-K annual reports for a portfolio of companies to analyze financial statements programmatically.
- Retrieve all 8-K current reports for a ticker within a date range to track material events and corporate actions.
- Automate collection of 13F-HR filings from institutional investors to monitor portfolio holdings changes.
- Build a financial data pipeline that fetches the latest SEC filings for a watchlist of companies on a scheduled basis.
- Download DEF 14A proxy statements to analyze executive compensation and shareholder proposals.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Downloads SEC EDGAR company filings by ticker or CIK, supporting all SEC filing types with optional date filtering and amendment inclusion.

Yes. The package is actively maintained, has no known vulnerabilities, installs with minimal friction, and solves a real problem—automating SEC filing retrieval that would otherwise require manual downloads or web scraping. MIT licensing removes legal barriers. Suitable for financial research, compliance automation, and data pipeline work.

## Install

pip install sec-edgar-downloader
uv add sec-edgar-downloader
poetry add sec-edgar-downloader

## Installing sec-edgar-downloader

Before you install: Low friction install with only two runtime dependencies (requests and pyrate-limiter). Actively maintained with recent commits and a stable production release status.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal legal friction for commercial or private projects.

Quickstart:

pip install sec-edgar-downloader

from sec_edgar_downloader import Downloader

dl = Downloader("MyCompanyName", "my.email@domain.com")
dl.get("10-K", "AAPL", limit=5)

Requires Python 3.10 or later. Must provide a company name and email address to form a user-agent string compliant with SEC EDGAR's fair access policy.

Verify before relying:

- Whether rate limiting via pyrate-limiter is configurable or automatic per SEC guidelines
- Performance characteristics when downloading large batches of filings across multiple companies
- Whether filing details download includes parsed structured data or raw document files

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 210.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

SEC EDGAR filing downloader, download SEC filings python, SEC 10-K 8-K downloader, company filing retrieval, SEC filing automation, EDGAR database access, financial filing scraper, financial-data, sec-filings, web-scraping

[View on SkillFed](https://skillfed.io/packages/sec-edgar-downloader) · [View on PyPI](https://pypi.org/project/sec-edgar-downloader/)