# SEC EDGAR & Yahoo Finance Scraper - Filings, Quotes, $0.35/1K (`sweet_stickball/sec-edgar-yahoo-finance`) Actor

Scrape SEC EDGAR filings (10-K, 10-Q, 8-K) by ticker or CIK, plus stock quotes and annual financial statements from Yahoo Finance. SEC filings scraper and stock data API alternative with flat JSON output.

- **URL**: https://apify.com/sweet_stickball/sec-edgar-yahoo-finance.md
- **Developed by:** [CrawlKit](https://apify.com/sweet_stickball) (community)
- **Categories:** Business, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.21 / 1,000 filings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SEC EDGAR & Yahoo Finance Scraper - Filings, Quotes, $0.35/1K

Pull SEC filings and market data for a US-listed company. Give it a ticker or CIK and get back 10-K/10-Q/8-K filings, a current stock quote, or annual financial statements as flat JSON. No API key needed.

Filings come from the **SEC EDGAR API** (`data.sec.gov`); quotes and financial statements come from **Yahoo Finance public endpoints**. One data type per run.

### Features

- **SEC filings** — 10-K, 10-Q, 8-K (or any form types you list) with direct links to the source documents on sec.gov
- **Quotes** — price, change, previous close, volume, currency, exchange, 52-week range (market cap, P/E and EPS are filled only when the quote comes from Yahoo's summary endpoint, otherwise `null`)
- **Financial statements** — revenue, net income, gross profit, operating income, EBIT, EPS, total assets, liabilities, equity, cash, debt, one record per annual period
- **Ticker or CIK** — type `AAPL` or `0000320193`; tickers are resolved to a CIK via the SEC ticker map
- **Flat output** — no nested objects, ready for spreadsheets, dashboards or AI/LLM pipelines

### Input

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `ticker` | string | Yes | — | Stock ticker (AAPL, TSLA) or SEC CIK number (0000320193) |
| `type` | enum | No | `quotes` | `filings`, `quotes`, or `financials` |
| `maxItems` | integer | No | 20 | Max filings to return (only for `filings` type) |
| `filingTypes` | string | No | `10-K,10-Q,8-K` | Comma-separated SEC form types to include |

### Output Examples

#### Quotes (`type: "quotes"`)

```json
{
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "price": 227.55,
    "change": 1.23,
    "change_percent": 0.54,
    "previous_close": 226.32,
    "volume": 48123456,
    "market_cap": null,
    "pe_ratio": null,
    "eps": null,
    "currency": "USD",
    "exchange": "NMS",
    "fifty_two_week_high": 260.10,
    "fifty_two_week_low": 164.08
}
```

#### Filings (`type: "filings"`)

```json
{
    "ticker": "AAPL",
    "company_name": "Apple Inc.",
    "cik": "0000320193",
    "form_type": "10-K",
    "filing_date": "2024-11-01",
    "accepted_date": "2024-11-01T06:01:36.000Z",
    "accession_number": "0000320193-24-000123",
    "document_url": "https://www.sec.gov/Archives/edgar/data/320193/...",
    "description": "10-K",
    "edgar_url": "https://www.sec.gov/cgi-bin/browse-edgar?..."
}
```

#### Financials (`type: "financials"`)

```json
{
    "ticker": "AAPL",
    "period": "2024-09-28",
    "revenue": 394328000000,
    "net_income": 93736000000,
    "gross_profit": 180683000000,
    "operating_income": 118658000000,
    "ebit": 123217000000,
    "eps": 6.08,
    "total_assets": 364980000000,
    "total_liabilities": 308030000000,
    "total_equity": 56950000000,
    "cash": 29943000000,
    "total_debt": 97000000000
}
```

### Who uses this

- **Investors & analysts** — due diligence, earnings tracking, fundamental analysis
- **Compliance teams** — monitor 8-K filings for material events across a watchlist
- **AI/LLM agents** — structured financial context for research, summarization, or trading signal pipelines
- **No-code automations** — pipe straight into Google Sheets, Airtable, or Slack via Apify integrations

### Pricing

Pay-per-event, **no start fee**: **$0.35 per 1,000 filings** and **$0.35 per 1,000 quotes / financials** (one per ticker) on the Apify Free plan, with lower prices on paid plans.

| Event | Free | Starter | Scale | Business | Enterprise |
|-------|------|---------|-------|----------|------------|
| Filing (`FILING`) | $0.35 | $0.30 | $0.26 | $0.21 | $0.21 |
| Quote / financials (`QUOTE_BATCH`) | $0.35 | $0.30 | $0.26 | $0.21 | $0.21 |

Prices in USD per 1,000 events.

#### Cost examples (Free plan)

| Scenario | Events | Cost |
|----------|--------|------|
| Single stock quote | 1 QUOTE_BATCH | $0.00035 |
| Financial statements (4 periods) | 1 QUOTE_BATCH | $0.00035 |
| 20 recent filings | 20 FILINGs | $0.007 |
| 100 filings deep dive | 100 FILINGs | $0.035 |

### Under the hood

Python 3.11, async httpx, Apify SDK. Requests go through Apify Proxy when available. Yahoo Finance requests switch to a fresh proxy session (datacenter first, then residential) when Yahoo rate-limits or blocks one, and give up after about 40 seconds. SEC requests send a contact User-Agent as required by SEC EDGAR's fair-access policy.

### Limitations

- **Sources** — quotes and financials come from Yahoo Finance public (undocumented) endpoints, which may rate-limit or change without notice; filings come from SEC EDGAR. If Yahoo returns no data, the run ends FAILED with the reason.
- **SEC-registered companies only** — filings require a CIK in EDGAR; quotes/financials depend on the ticker being known to Yahoo Finance.
- **Quote timing** — the price is what Yahoo Finance returns at run time; it may be delayed depending on the exchange.
- **Financial statements** — annual periods only (as returned by Yahoo Finance, typically the last few years); for quarterly detail, pull 10-Q filings.
- **Filings** — taken from EDGAR's list of recent filings for the company; `maxItems` caps the number returned.
- **One ticker per run** — run the actor once per ticker (or schedule several runs).

### Feedback

Found a bug or need a field? Open an issue on the Issues tab; if the Actor helps you, a review on the Reviews tab helps others find it.

### Related Actors

- [Google News Scraper - Multi-Keyword & New Articles, $1.40/1K](https://apify.com/sweet_stickball/google-news-scraper) — Scrape Google News articles for any keyword: headlines, sources, dates and URLs by country and language. News monitoring API, no API key or login.
- [Google Trends Scraper - Interest & Related Queries, $0.58/1K](https://apify.com/sweet_stickball/google-trends-scraper) — Scrape Google Trends: interest over time and related queries for up to 5 compared keywords, by country, time range and category.

# Actor input Schema

## `ticker` (type: `string`):

Stock ticker symbol (e.g. AAPL, TSLA, MSFT) or SEC CIK number (e.g. 0000320193). The actor auto-detects the format.

## `type` (type: `string`):

What data to fetch: 'filings' for SEC filings (10-K, 10-Q, 8-K), 'quotes' for real-time stock quote, or 'financials' for income/balance sheet data.

## `maxItems` (type: `integer`):

Maximum number of filings to return (only applies to type='filings'). Ignored for quotes and financials.

## `filingTypes` (type: `string`):

Comma-separated list of SEC form types to include (only for type='filings'). Leave empty for all types. Examples: '10-K,10-Q,8-K'

## Actor input object example

```json
{
  "ticker": "AAPL",
  "type": "filings",
  "maxItems": 10,
  "filingTypes": "10-K,10-Q,8-K"
}
```

# Actor output Schema

## `filings` (type: `string`):

Dataset items shown with the 'filings' view.

## `overview` (type: `string`):

Dataset items shown with the 'overview' view.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "ticker": "AAPL",
    "type": "filings",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("sweet_stickball/sec-edgar-yahoo-finance").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "ticker": "AAPL",
    "type": "filings",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("sweet_stickball/sec-edgar-yahoo-finance").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "ticker": "AAPL",
  "type": "filings",
  "maxItems": 10
}' |
apify call sweet_stickball/sec-edgar-yahoo-finance --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sweet_stickball/sec-edgar-yahoo-finance"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/MqpXdj8hc2slTfHth/builds/Gnruw0r8pbGKuJLwo/openapi.json
