# SEC 13F Institutional Holdings Scraper by Fund CIK (`parkero/sec-institutional-holdings`) Actor See what hedge funds and institutional investors own. Scrape SEC Form 13F holdings for any fund by CIK — Berkshire Hathaway, Scion, and thousands more. Get each position issuer, CUSIP, market value, and share count, normalized to whole dollars. Official SEC filings. No API key. - **URL**: https://apify.com/parkero/sec-institutional-holdings.md - **Developed by:** [parker odam](https://apify.com/parkero) (community) - **Categories:** Business, Developer tools - **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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 13F Institutional Holdings Scraper by Fund CIK Scrape SEC Form 13F institutional holdings disclosures — what stocks hedge funds, mutual funds, and other large institutions own. Funds are legally required to disclose all equity holdings >= $100M quarterly. **Keywords:** 13F holdings scraper, institutional holdings data, hedge fund holdings by CIK, SEC 13F API, what stocks does a fund own, institutional investor positions, fund portfolio tracker, 13F-HR filings, EDGAR institutional data. ### Input The key difference from stock scrapers: **13F filers are INSTITUTIONS (funds, advisors), not individual stocks.** They are identified by a CIK (Central Index Key), not a stock ticker. **How to find a fund's CIK:** 1. Go to https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany 2. Search by company name 3. Grab the CIK from the URL or results table **Examples:** | Fund | CIK | |------|-----| | Berkshire Hathaway | 1067983 | | Vanguard Group | 102909 | | BlackRock | 1364742 | | Bridgewater Associates | 1159165 | | Renaissance Technologies | 1037389 | #### Input schema ```json { "ciks": ["1067983"], "maxFilings": 1, "includeAmendments": false, "userAgent": "my-app/1.0 contact@mydomain.com" } ``` | Field | Required | Description | |-------|----------|-------------| | `ciks` | Yes | Array of fund CIK numbers | | `maxFilings` | No | Max filings per fund (default: all). Set to 1 for current quarter only. | | `includeAmendments` | No | Include 13F-HR/A amendments (default: false) | | `userAgent` | No | Your contact info for SEC's fair-use policy (required by SEC; defaults to placeholder) | ### Output One record per `` row in the 13F filing — one row = one security holding. ```json { "fundName": "BERKSHIRE HATHAWAY INC", "fundCik": "0001067983", "reportPeriod": "2026-03-31", "nameOfIssuer": "APPLE INC", "titleOfClass": "COM", "cusip": "037833100", "valueRaw": 50000000000, "valueInThousands": false, "valueUsd": 50000000000, "shares": 300000000, "sharesType": "SH", "investmentDiscretion": "DFND", "votingSole": 300000000, "votingShared": 0, "votingNone": 0, "accessionNumber": "0001193125-26-226661", "filedDate": "2026-05-15", "filingUrl": "https://www.sec.gov/Archives/edgar/data/1067983/000119312526226661/53405.xml" } ``` #### Value units (important!) The SEC changed how 13F filers report `value` in late 2022 (Release No. 34-96459): - **Before ~2023-02-01**: `value` was reported in **thousands of USD** - **On/after ~2023-02-01**: `value` is reported in **whole USD** This actor normalizes everything to whole USD in `valueUsd`. The raw value from the XML is in `valueRaw`, and `valueInThousands` tells you which era applied. ### Data source All data comes from SEC EDGAR — the official public disclosure database: - Submissions: `https://data.sec.gov/submissions/CIK##########.json` - Filing index: `https://www.sec.gov/Archives/edgar/data///index.json` - Infotable XML: `https://www.sec.gov/Archives/edgar/data///.xml` No API key required. The SEC requires a descriptive User-Agent with a contact email; set the `userAgent` input field to comply with their fair-use policy. Rate limiting is built in (120ms minimum between requests per host). # Actor input Schema ## `ciks` (type: `array`): One or more SEC Central Index Key (CIK) numbers identifying the institutional filers (funds, advisors) to query. 13F filers are identified by CIK — they do NOT have stock tickers. To find a fund's CIK: visit https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany and search by company name. Examples: 1067983 (Berkshire Hathaway), 102909 (Vanguard Group), 1364742 (BlackRock). ## `includeAmendments` (type: `boolean`): Include 13F-HR/A amendment filings in addition to original 13F-HR filings. Amendments correct errors in the original. Most use cases only need the original filings — enable this for full historical fidelity. ## `maxFilings` (type: `integer`): Maximum number of 13F filings to process per fund CIK, applied to the most recent filings first. Set to 1 to get the current quarter's holdings only. Leave blank to retrieve all available filings (can be many years of history). ## `userAgent` (type: `string`): User-Agent string sent with every request to SEC EDGAR. The SEC's fair-access policy REQUIRES a descriptive User-Agent that identifies your tool and includes a contact email address. Requests without a proper User-Agent are rejected with HTTP 403. Format: 'YourToolName/1.0 contact@yourdomain.com'. See https://www.sec.gov/os/webmaster-faq#developers ## Actor input object example ```json { "ciks": [ "1067983" ], "includeAmendments": false, "maxFilings": 1, "userAgent": "my-holdings-app/1.0 your-email@example.com" } ``` # 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 = { "ciks": [ "1067983" ], "maxFilings": 1, "userAgent": "my-holdings-app/1.0 your-email@example.com" }; // Run the Actor and wait for it to finish const run = await client.actor("parkero/sec-institutional-holdings").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 = { "ciks": ["1067983"], "maxFilings": 1, "userAgent": "my-holdings-app/1.0 your-email@example.com", } # Run the Actor and wait for it to finish run = client.actor("parkero/sec-institutional-holdings").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 '{ "ciks": [ "1067983" ], "maxFilings": 1, "userAgent": "my-holdings-app/1.0 your-email@example.com" }' | apify call parkero/sec-institutional-holdings --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parkero/sec-institutional-holdings" } } } ``` 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 ` 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/UK1KR19VowOg2g5lJ/builds/iSXcIc4S8FC4Ychda/openapi.json