SEC 13F Holdings Scraper

Parse official SEC EDGAR Form 13F filings into clean, row-per-holding data for institutional ownership research, portfolio monitoring, and AI-agent workflows.

What it does

The actor reads SEC submissions metadata, locates the filing's Information Table XML, and returns one structured record per reported security. It is HTTP-first and uses the SEC's public EDGAR endpoints; no login, third-party data provider, or browser session is required.

Field group	Returned data
Manager	Manager name and ten-digit SEC CIK
Filing	Form type, accession number, filing date, reporting period, SEC archive link
Security	Issuer, class, CUSIP, shares/principal, SH/PRN type, PUT/CALL
Valuation	Value in thousands, converted market value in USD, parsed portfolio weight
Control	Investment discretion, other manager, sole/shared/none voting authority
Provenance	Direct Information Table XML URL, collection timestamp, warnings

When to use it

Use it to inspect quarterly institutional holdings for investment research, manager comparisons, ownership monitoring, competitive intelligence, and data pipelines. It is a good fit when you need the as-filed SEC position data with a verifiable source URL.

Do not use it for real-time positions, trade execution, performance attribution, short positions, or a complete portfolio: Form 13F is a delayed disclosure and covers only reportable Section 13(f) securities. Review the original SEC filing before making an investment decision.

Input

All fields are optional. The default run uses Berkshire Hathaway's CIK (0001067983) and collects up to four recent initial 13F-HR filings, capped at 500 holding records.

{
  "cik": "0001067983",
  "maxFilings": 4,
  "maxItems": 500,
  "includeAmendments": false
}

For a manager lookup, provide managerName and leave cik blank. For a precise filing, use filingAccession together with the institutional filer's cik, for example filingAccession: "0001193125-26-226661" and cik: "0001067983"; SEC accession prefixes identify the filing agent and are not always the filer CIK. cik takes precedence over managerName. periodOfReport accepts an exact quarter-end ISO date such as 2025-12-31.

Set the optional SEC_USER_AGENT environment variable in Apify Console to a descriptive value that includes a contact address or URL. The actor uses a conservative request delay and retries transient SEC responses. The fallback User-Agent identifies the actor, but a contact-bearing value is recommended for production use.

Output

Example item:

{
  "managerName": "Berkshire Hathaway Inc",
  "cik": "0001067983",
  "formType": "13F-HR",
  "accessionNumber": "0001067983-25-000003",
  "filingDate": "2025-02-14",
  "periodOfReport": "2024-12-31",
  "nameOfIssuer": "APPLE INC",
  "titleOfClass": "COM",
  "cusip": "037833100",
  "valueThousands": 35500000,
  "marketValueUsd": 35500000000,
  "portfolioWeightPct": 12.345678,
  "sharesOrPrincipal": 830000000,
  "securityType": "SH",
  "putCall": null,
  "investmentDiscretion": "SOLE",
  "otherManager": null,
  "votingSole": 830000000,
  "votingShared": 0,
  "votingNone": 0,
  "filingUrl": "https://www.sec.gov/Archives/edgar/data/1067983/000106798325000003/",
  "informationTableUrl": "https://www.sec.gov/Archives/edgar/data/1067983/000106798325000003/InfoTable.xml",
  "scrapedAt": "2026-08-02T12:00:00.000Z",
  "warnings": []
}

valueThousands follows the SEC Information Table convention. marketValueUsd is the same reported value multiplied by 1,000; it is not a live market price. portfolioWeightPct is calculated from the sum of parsed Information Table values in that filing, so it is approximate for amendments or unusual filings.

Pricing

Event	Price
Actor start	$0.00005 per run
Holding record	$0.005 per stored record

The run status reports the record cap before collection. A 100-record run costs approximately $0.50 in record events plus the start event. The actor also supports Apify's usage-based billing option when enabled for the actor.

API and MCP examples

Run with the Apify API:

curl "https://api.apify.com/v2/acts/YOUR_USERNAME~sec-13f-holdings-scraper/runs?token=YOUR_TOKEN" \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{"cik":"0001067983","periodOfReport":"2025-12-31","maxItems":100}'

JavaScript:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('YOUR_USERNAME/sec-13f-holdings-scraper').call({
  cik: '0001067983',
  maxFilings: 1,
  maxItems: 25,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

For MCP, add the actor through Apify MCP and call it with a CIK, manager name, accession, or reporting period. The tool returns a compact dataset preview and a dataset ID for paging through the complete result set.

Limits and reliability

• Maximum 20 filings and 5,000 holding records per run.
• The default run is intentionally small enough for Apify health checks.
• The actor uses SEC EDGAR submissions and archive endpoints, with one request at a time and retry/backoff for 403, 429, and transient 5xx responses.
• SEC filing layouts are authoritative but are supplied by individual filers; an unusual or malformed filing can produce a warning or no rows.
• Initial reports and amendments are not automatically merged. Set includeAmendments when you need amendments, then deduplicate or choose the filing version in downstream analysis.
• Manager-name search first uses SEC's public company ticker directory and then EDGAR full-text search. For deterministic automation, prefer an exact CIK.

Legal and research note

This actor accesses public SEC EDGAR data for research and automation. It does not provide investment advice, a recommendation, or real-time market data. Form 13F is delayed and incomplete by design; verify important facts against the original SEC filing and consult a qualified professional before making financial decisions. Respect SEC access guidance and provide a descriptive User-Agent contact when operating at scale.