A reliable tool for collecting official 8-K and 10-K company filings directly from the SEC EDGAR system using ticker symbols. It simplifies access to structured financial disclosures, enabling faster research, compliance checks, and financial analysis.
Created by Bitbash, built to showcase our approach to Scraping and Automation!
If you are looking for sec-edgar-filing-scraper-8-k-and-10-k-reports you've just found your team — Let’s Chat. 👆👆
This project retrieves publicly available 8-K and 10-K filings from the SEC EDGAR database in a clean, structured format. It solves the challenge of manually navigating EDGAR by automating filing discovery and normalization for downstream use. It is built for analysts, developers, compliance teams, and researchers who need consistent access to SEC filings.
- Retrieves the latest 8-K and 10-K filings by company ticker
- Normalizes filing metadata into structured records
- Designed for repeatable, large-scale data collection
- Suitable for analytics, auditing, and reporting workflows
| Feature | Description |
|---|---|
| Ticker-Based Lookup | Fetch filings using simple company ticker symbols. |
| 8-K & 10-K Coverage | Focuses on the most critical SEC disclosure forms. |
| Structured Output | Delivers clean, machine-readable filing metadata. |
| Official Source Data | Pulls data directly from authoritative SEC records. |
| Scalable Design | Handles multiple companies efficiently in one run. |
| Field Name | Field Description |
|---|---|
| filing_url | Direct link to the official filing document. |
| form_type | Type of SEC form (8-K or 10-K). |
| primary_document_description | Description of the main filing document. |
| filing_date | Date the filing was officially submitted. |
| acceptance_datetime | Exact timestamp when the filing was accepted by the SEC. |
[
{
"Filing URL": "https://www.sec.gov/Archives/edgar/data/0001318605/000110465925050072/tm2515421d1_8k.htm",
"Form Type": "8-K",
"Primary Document Description": "FORM 8-K",
"Filing Date": "2025-05-16",
"Acceptance Date Time": "2025-05-16T21:01:19.000Z"
}
]
SEC EDGAR Filing Scraper (8-K and 10-K Reports)/
├── src/
│ ├── main.py
│ ├── fetcher/
│ │ ├── edgar_client.py
│ │ └── ticker_resolver.py
│ ├── parsers/
│ │ └── filing_parser.py
│ ├── utils/
│ │ └── date_utils.py
│ └── config/
│ └── settings.example.json
├── data/
│ ├── sample_input.json
│ └── sample_output.json
├── requirements.txt
└── README.md
- Financial analysts use it to collect SEC filings, so they can evaluate company disclosures faster.
- Compliance teams use it to monitor regulatory filings, so they can meet reporting obligations.
- Investors use it to track material events, so they can make informed decisions.
- Researchers use it to build datasets of filings, so they can analyze disclosure trends.
- Developers use it to integrate filing data, so they can power finance-focused applications.
Which filing types are supported? The scraper focuses on 8-K and 10-K filings, covering both event-driven disclosures and annual reports.
How does it identify companies? Companies are identified using standard ticker symbols, which are mapped to their official SEC records.
Is historical data included? Yes, available historical filings for the specified forms are included based on SEC availability.
Can it handle multiple tickers at once? Yes, it is designed to process multiple companies efficiently in a single execution.
Primary Metric: Processes an average company’s filings in under 2 seconds.
Reliability Metric: Maintains a successful retrieval rate above 99% for valid tickers.
Efficiency Metric: Optimized requests minimize redundant calls to public endpoints.
Quality Metric: Delivers complete filing metadata with consistent field accuracy across records.
"Bitbash is a top-tier automation partner, innovative, reliable, and dedicated to delivering real results every time." Nathan Pennington
|
"Bitbash delivers outstanding quality, speed, and professionalism, truly a team you can rely on." Eliza
|
"Exceptional results, clear communication, and flawless delivery. Syed
|