# SEC 13D/13G Beneficial Ownership Filings Scraper (`v0iddo/sec-13d-13g-beneficial-ownership`) Actor Scrape SEC EDGAR 13D and 13G beneficial ownership filings by company CIK. Track activist investor 5%+ stake disclosures and ownership changes. Returns accession number, form, filing date, report date, primary doc URL. - **URL**: https://apify.com/v0iddo/sec-13d-13g-beneficial-ownership.md - **Developed by:** [vøiddo](https://apify.com/v0iddo) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.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 13D/13G Beneficial Ownership Filings Scraper Pull SEC 13D and 13G beneficial ownership filings from EDGAR by company CIK. Track activist investor positions, 5%+ stakes, and ownership changes. No API key required — uses the free public EDGAR submissions API. ### Example output row ```json { "cik": "0000320193", "company_name": "Apple Inc.", "accession_number": "0000902664-23-001234", "form": "SC 13G/A", "filing_date": "2023-02-10", "report_date": "2022-12-31", "primary_document": "https://www.sec.gov/Archives/edgar/data/320193/000090266423001234/sc13ga.txt", "primary_doc_description": "SC 13G/A" } ```` ### How to use Provide an array of 10-digit zero-padded SEC CIK numbers. You can look up a company's CIK at [EDGAR full-text search](https://efts.sec.gov/LATEST/search-index?q=%22apple%22\&dateRange=custom\&startdt=2020-01-01\&enddt=2023-01-01\&forms=10-K). **Input schema:** ```json { "cik": [ "0000320193", "0001318605", "0001067983" ] } ``` | Field | Type | Required | Description | |-------|------|----------|-------------| | `cik` | `string[]` | No | 10-digit zero-padded CIK numbers. Defaults to Apple, Tesla, Berkshire Hathaway if omitted. | If you supply a shorter CIK (e.g. `"320193"`), the actor zero-pads it to 10 digits automatically. **Output fields per row:** | Field | Description | |-------|-------------| | `cik` | Zero-padded 10-digit CIK | | `company_name` | Company name from EDGAR | | `accession_number` | Filing accession number (e.g. `0000902664-23-001234`) | | `form` | Form type: `SC 13D`, `SC 13D/A`, `SC 13G`, `SC 13G/A` | | `filing_date` | Date the filing was submitted to SEC | | `report_date` | Period of report (end of calendar year for most 13G) | | `primary_document` | Direct URL to the primary filing document | | `primary_doc_description` | Description of the primary document | Only `SC 13D`, `SC 13D/A`, `SC 13G`, and `SC 13G/A` filings are returned. Other filing types are filtered out. ### Pricing **Event:** `dataset-item` — charged once per row returned.\ **Rate:** $0.001 per item. A run pulling 13D/13G filings for 20 large-cap companies typically returns 50–300 rows, costing $0.05–$0.30. ### Buyer - **Hedge funds and equity analysts** monitoring activist investor accumulation in portfolio companies - **M\&A and legal teams** tracking 5%+ ownership stakes that trigger Schedule 13D/13G disclosure obligations - **Quant researchers** building ownership-change signals and institutional holding datasets - **Compliance teams** ensuring awareness of major ownership events in covered companies - **Financial data vendors** enriching EDGAR pipelines without building SEC API integrations in-house ### Source **EDGAR Submissions API**\ `GET https://data.sec.gov/submissions/CIK{cik}.json` - Free, no API key required - Rate limit: 10 requests/second per IP - Returns full filing history in `filings.recent` parallel arrays - Older filings (beyond the recent window) are in shards listed under `filings.files[].name` - SEC requires a `User-Agent` header identifying your application and contact email Official documentation: [EDGAR EFTS API](https://efts.sec.gov/LATEST/search-index?q=%2213D%22\&forms=SC+13D)\ EDGAR full submissions: [data.sec.gov](https://data.sec.gov/submissions/) # Actor input Schema ## `cik` (type: `array`): 10-digit zero-padded SEC CIK numbers ## Actor input object example ```json { "cik": [ "0000320193", "0001318605", "0001067983" ] } ``` # 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 = { "cik": [ "0000320193", "0001318605", "0001067983" ] }; // Run the Actor and wait for it to finish const run = await client.actor("v0iddo/sec-13d-13g-beneficial-ownership").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 = { "cik": [ "0000320193", "0001318605", "0001067983", ] } # Run the Actor and wait for it to finish run = client.actor("v0iddo/sec-13d-13g-beneficial-ownership").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 '{ "cik": [ "0000320193", "0001318605", "0001067983" ] }' | apify call v0iddo/sec-13d-13g-beneficial-ownership --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=v0iddo/sec-13d-13g-beneficial-ownership", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC 13D/13G Beneficial Ownership Filings Scraper", "description": "Scrape SEC EDGAR 13D and 13G beneficial ownership filings by company CIK. Track activist investor 5%+ stake disclosures and ownership changes. Returns accession number, form, filing date, report date, primary doc URL.", "version": "0.1", "x-build-id": "OXFGqkGFCZJsHECPm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/v0iddo~sec-13d-13g-beneficial-ownership/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-v0iddo-sec-13d-13g-beneficial-ownership", "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/v0iddo~sec-13d-13g-beneficial-ownership/runs": { "post": { "operationId": "runs-sync-v0iddo-sec-13d-13g-beneficial-ownership", "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/v0iddo~sec-13d-13g-beneficial-ownership/run-sync": { "post": { "operationId": "run-sync-v0iddo-sec-13d-13g-beneficial-ownership", "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": { "cik": { "title": "cik", "type": "array", "description": "10-digit zero-padded SEC CIK numbers", "default": [], "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```