# SEC EDGAR Filings Scraper (`exuberant_volley/sec-edgar-filings-scraper`) Actor Scrape a company's recent SEC EDGAR filings by ticker or CIK — form type, filing date, accession number and primary document. Filter by form type. Official SEC data, no personal data. - **URL**: https://apify.com/exuberant\_volley/sec-edgar-filings-scraper.md - **Developed by:** [ScrapeForge](https://apify.com/exuberant_volley) (community) - **Categories:** News, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## SEC EDGAR Scraper — Company Filings by Ticker (10-K, 10-Q, 8-K) **Launch pricing: this actor currently adds no fee — run it on your Apify free-plan credits. Try it, bookmark it, wire it into your stack.** A **SEC EDGAR scraper** and **SEC filings scraper** on the SEC's official data API: **scrape SEC filings** for any US public company by ticker or CIK — form type, filing date, report date, accession number and primary document — as clean JSON. This **EDGAR API scraper** needs no API key and is the fastest way to get **10-K 10-Q 8-K filings data** into a sheet, a pipeline or an alert. > Ticker in, filing history out: the actor resolves the ticker to a CIK and returns the company's recent filings, filterable by form type. ### Who uses this - **Financial analysts** — pull a company's filing cadence and jump straight to primary documents. - **Fintech & data engineers** — a keyless, schedulable EDGAR feed for apps and internal tools. - **Compliance & legal teams** — monitor specific form types (8-K, S-1, 13D) for watched companies. - **Journalists & researchers** — instant filing history for any ticker, no Bloomberg needed. Tracking executive changes specifically? The [Executive Changes Tracker](https://apify.com/exuberant_volley/executive-changes-scraper) parses 8-K Item 5.02 filings into person-level appointment/departure records. ### How it works The actor resolves your ticker via the SEC's `company_tickers.json` (or uses your explicit CIK), fetches the company's recent-filings index from `data.sec.gov/submissions`, applies your `formTypes` filter, and outputs the newest filings first. Every request sends a descriptive User-Agent per SEC fair-access rules. A run that matches zero filings **fails loudly instead of succeeding empty**. ### Output One record per filing: ```json { "cik": "0000320193", "company": "Apple Inc.", "form": "4", "filingDate": "2026-06-17", "reportDate": "2026-06-15", "accessionNumber": "0001140361-26-025622", "primaryDocument": "xslF345X06/form4.xml", "primaryDocDescription": "FORM 4", "scrapedAt": "2026-07-15T09:35:29.868Z" } ```` - Build the document URL as `https://www.sec.gov/Archives/edgar/data///`. - `reportDate` is the period the filing covers; `filingDate` is when it hit EDGAR. ### Input | Field | Default | Description | |---|---|---| | `ticker` | `AAPL` | Stock ticker to resolve to a CIK | | `cik` | — | Explicit CIK (overrides ticker; leading zeros optional) | | `formTypes` | all forms | Keep only these forms (e.g. `["10-K","10-Q","8-K"]`); empty = all | | `maxItems` | `100` | Stop after this many filings (newest first) | **The default run needs no configuration** — an empty input returns Apple's 100 most recent filings of any form. ### Reliability & limits - Covers the company's **recent filings index** (the SEC's `submissions` API returns roughly the last 1000 filings; older history lives in EDGAR archives). - Official SEC data — US government public-domain source; requests stay well under SEC fair-access rate limits. - A `formTypes` filter can legitimately reduce results below `maxItems`; an impossible filter fails loudly rather than returning an empty dataset. ### Paste this output into… - **Google Sheets** — `=IMPORTDATA("https://api.apify.com/v2/acts/exuberant_volley~sec-edgar-filings-scraper/runs/last/dataset/items?format=csv&clean=1&token=YOUR_TOKEN")` for a filing-history sheet per ticker. - **Make / n8n** — schedule daily with `formTypes: ["8-K"]`, fetch `.../runs/last/dataset/items`, and alert on any `accessionNumber` you haven't seen before. - **Filing-watch alerts (analysts)** — one scheduled run per watched ticker; a new 10-Q row in the diff = earnings docs are out, hours before most aggregators surface them. ### ScrapeForge free data suite One publisher, fourteen plug-and-play datasets — all currently free to run: | Actor | What it delivers | | |---|---|---| | [Executive Changes Tracker](https://apify.com/exuberant_volley/executive-changes-scraper) | New CEO/CFO/board moves from SEC 8-Ks + official newswires — source-cited B2B trigger leads | [run it next →](https://apify.com/exuberant_volley/executive-changes-scraper) | | [IKEA Product Scraper](https://apify.com/exuberant_volley/ikea-product-scraper) | Names, prices, ratings and images from any IKEA search or category page | [run it next →](https://apify.com/exuberant_volley/ikea-product-scraper) | | [Shopify Store Scraper](https://apify.com/exuberant_volley/shopify-store-scraper) | Any Shopify store's full catalog — variants, SKUs, prices — via products.json | [run it next →](https://apify.com/exuberant_volley/shopify-store-scraper) | | [App Store Apps Scraper](https://apify.com/exuberant_volley/app-store-apps-scraper) | App rankings, ratings, prices and metadata by keyword, any country | [run it next →](https://apify.com/exuberant_volley/app-store-apps-scraper) | | [Remote Jobs Scraper](https://apify.com/exuberant_volley/remote-jobs-scraper) | Live remote listings from RemoteOK + Remotive, keyword-filtered | [run it next →](https://apify.com/exuberant_volley/remote-jobs-scraper) | | [CoinGecko Market Scraper](https://apify.com/exuberant_volley/coingecko-market-scraper) | Top-coin prices, market caps and 24h moves — keyless | [run it next →](https://apify.com/exuberant_volley/coingecko-market-scraper) | | [GitHub Repositories Scraper](https://apify.com/exuberant_volley/github-repos-scraper) | Repo search with stars, forks, topics and licenses | [run it next →](https://apify.com/exuberant_volley/github-repos-scraper) | | [Hacker News Scraper](https://apify.com/exuberant_volley/hackernews-scraper) | Top/New/Best HN stories with scores and comment counts | [run it next →](https://apify.com/exuberant_volley/hackernews-scraper) | | [Wikipedia Scraper](https://apify.com/exuberant_volley/wikipedia-scraper) | Article summaries, images and URLs in any language — RAG-ready | [run it next →](https://apify.com/exuberant_volley/wikipedia-scraper) | | [SEC EDGAR Filings Scraper](https://apify.com/exuberant_volley/sec-edgar-filings-scraper) | Any US public company's filing history by ticker | [run it next →](https://apify.com/exuberant_volley/sec-edgar-filings-scraper) | | [Open-Meteo Weather Scraper](https://apify.com/exuberant_volley/open-meteo-weather-scraper) | 16-day daily forecast for any coordinates — temps, rain, wind — keyless | [run it next →](https://apify.com/exuberant_volley/open-meteo-weather-scraper) | | [arXiv Papers Scraper](https://apify.com/exuberant_volley/arxiv-papers-scraper) | Research papers by topic — abstracts, categories, PDF links, newest-first sort | [run it next →](https://apify.com/exuberant_volley/arxiv-papers-scraper) | | [NVD CVE Scraper](https://apify.com/exuberant_volley/nvd-cve-scraper) | Fresh CVEs with CVSS severity, CWE ids and CISA known-exploited flags | [run it next →](https://apify.com/exuberant_volley/nvd-cve-scraper) | | [npm Registry Scraper](https://apify.com/exuberant_volley/npm-registry-scraper) | npm package vitals — latest version, license, weekly downloads, dependency count | [run it next →](https://apify.com/exuberant_volley/npm-registry-scraper) | ### Compliance - Every request sends a descriptive `User-Agent` as required by SEC fair-access rules, and stays well under the SEC's rate ceiling. - **No personal data is collected** — only filing metadata (form type, dates, document names). SEC EDGAR data is US government public-domain. - Records live only in your run's dataset; the actor keeps nothing beyond it. # Actor input Schema ## `ticker` (type: `string`): Stock ticker to resolve to a CIK (e.g. AAPL, MSFT, TSLA). Ignored if a CIK is provided. ## `cik` (type: `string`): SEC Central Index Key. Overrides the ticker. Leading zeros optional (e.g. 320193 or 0000320193). ## `formTypes` (type: `array`): Only keep filings of these form types (e.g. 10-K, 10-Q, 8-K). Leave empty for all forms. ## `maxItems` (type: `integer`): Stop after this many filings (most recent first). ## Actor input object example ```json { "ticker": "AAPL", "formTypes": [ "10-K", "10-Q", "8-K" ], "maxItems": 100 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "ticker": "AAPL", "formTypes": [ "10-K", "10-Q", "8-K" ], "maxItems": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("exuberant_volley/sec-edgar-filings-scraper").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "ticker": "AAPL", "formTypes": [ "10-K", "10-Q", "8-K", ], "maxItems": 100, } # Run the Actor and wait for it to finish run = client.actor("exuberant_volley/sec-edgar-filings-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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", "formTypes": [ "10-K", "10-Q", "8-K" ], "maxItems": 100 }' | apify call exuberant_volley/sec-edgar-filings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=exuberant_volley/sec-edgar-filings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC EDGAR Filings Scraper", "description": "Scrape a company's recent SEC EDGAR filings by ticker or CIK — form type, filing date, accession number and primary document. Filter by form type. Official SEC data, no personal data.", "version": "0.1", "x-build-id": "02cOFIx7YcfG4Y2M5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/exuberant_volley~sec-edgar-filings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-exuberant_volley-sec-edgar-filings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/exuberant_volley~sec-edgar-filings-scraper/runs": { "post": { "operationId": "runs-sync-exuberant_volley-sec-edgar-filings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/exuberant_volley~sec-edgar-filings-scraper/run-sync": { "post": { "operationId": "run-sync-exuberant_volley-sec-edgar-filings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "ticker": { "title": "Ticker symbol", "type": "string", "description": "Stock ticker to resolve to a CIK (e.g. AAPL, MSFT, TSLA). Ignored if a CIK is provided.", "default": "AAPL" }, "cik": { "title": "CIK (optional)", "type": "string", "description": "SEC Central Index Key. Overrides the ticker. Leading zeros optional (e.g. 320193 or 0000320193)." }, "formTypes": { "title": "Form types (optional)", "type": "array", "description": "Only keep filings of these form types (e.g. 10-K, 10-Q, 8-K). Leave empty for all forms.", "items": { "type": "string" } }, "maxItems": { "title": "Max filings", "minimum": 1, "type": "integer", "description": "Stop after this many filings (most recent first).", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```