{ "openapi": "3.0.1", "info": { "title": "SEC Ownership API: 13F, N-PORT Fund Holdings, 13D/13G, Form 144", "description": "Who owns a stock, from official SEC filings: a fund manager's 13F holdings, a mutual fund's or ETF's N-PORT holdings (with changes), the funds holding a ticker, 5%+ stakes (13D/13G) and Form 144 planned insider sales. One ticker or fund in, JSON out, a source link per row.", "version": "0.1", "x-build-id": "0VYt6CVMgVH6OeJeV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bosco_labs~sec-ownership/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bosco_labs-sec-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/bosco_labs~sec-ownership/runs": { "post": { "operationId": "runs-sync-bosco_labs-sec-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/bosco_labs~sec-ownership/run-sync": { "post": { "operationId": "run-sync-bosco_labs-sec-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": { "mode": { "title": "What to look up", "enum": [ "holdings13f", "holdingsNport", "stakes13dg", "planned144" ], "type": "string", "description": "holdings13f = Form 13F: pass `filer` for a fund manager's holdings (with changes vs the previous quarter), or `ticker`/`cusip` for the managers holding a stock. holdingsNport = Form N-PORT: pass `fund` (a mutual fund or ETF ticker) for its holdings (with changes vs its previous report), or `ticker`/`cusip` for the mutual funds and ETFs holding a stock. stakes13dg = Schedule 13D/13G filings about `ticker`, or new 13D filings market-wide. planned144 = Form 144 notices of planned insider sales for `ticker`, or market-wide. Default holdings13f.", "default": "holdings13f" }, "filer": { "title": "13F filer (fund manager)", "pattern": "^[^\\[\\]{}<>\r\n]*$", "type": "string", "description": "holdings13f only: the fund manager's name or SEC CIK, e.g. \"Berkshire Hathaway\" or \"1067983\". A name is matched with EDGAR's company search (the first match that files 13F reports); a CIK is exact. Empty = look up the holders of `ticker`/`cusip` instead." }, "fund": { "title": "Mutual fund or ETF (N-PORT)", "pattern": "^\\s*([A-Za-z0-9][A-Za-z0-9 .,&'()/+-]{0,99})?\\s*$", "type": "string", "description": "holdingsNport only: the fund's ticker (any share class), e.g. \"VOO\" or \"ARKK\"; its SEC series ID, e.g. \"S000002839\"; or its name, e.g. \"Vanguard 500 Index Fund\" (matched with the SEC's series and class list; the fund picked and up to 3 close alternatives are named in the status message). Letters, digits, spaces and . , & ' ( ) / + -, up to 100 characters. Empty = look up the funds holding `ticker`/`cusip` instead." }, "ticker": { "title": "Ticker (issuer)", "pattern": "^(\\s*[A-Za-z0-9][A-Za-z0-9./-]{0,9}\\s*)?$", "type": "string", "description": "The company the shares are in, as a current US ticker, e.g. \"AAPL\". holdings13f/holdingsNport: the managers or funds holding it (or, with `filer`/`fund`, only that position). stakes13dg / planned144: filings about it. Empty = whole market (stakes13dg, planned144)." }, "issuerCik": { "title": "Issuer CIK", "pattern": "^(\\s*\\d{1,10}\\s*)?$", "type": "string", "description": "Instead of `ticker`: the company's SEC CIK as digits, e.g. \"320193\" for Apple. Use for delisted or renamed companies. Empty = use `ticker`." }, "cusip": { "title": "CUSIP (13F, N-PORT)", "pattern": "^(\\s*[A-Za-z0-9]{8}\\d\\s*)?$", "type": "string", "description": "holdings13f/holdingsNport only: the 9-character CUSIP of one share class, e.g. \"037833100\" (Apple common stock). Most precise way to ask which managers or funds hold a security. Empty = CUSIPs found in the company's recent Schedule 13D/13G filings (all its share classes)." }, "quarter": { "title": "Quarter (13F, N-PORT)", "pattern": "^\\s*(\\d{4}\\s*-?\\s*[Qq][1-4]|[Qq][1-4]\\s*-?\\s*\\d{4}|\\d{4}-\\d{2}-\\d{2}|\\d{1,2}[/-]\\d{1,2}[/-]\\d{4}|\\d{1,2}-[A-Za-z]{3}-\\d{4}|\\d{8})?\\s*$", "type": "string", "description": "holdings13f/holdingsNport only: the quarter of the holdings, as \"2026Q2\" or the quarter end \"2026-06-30\". Empty = the newest: the filer's or fund's latest report, or for holders of a stock the newest SEC data set (13F reports are due 45 days after quarter end; N-PORT reports are public 60 days after a fund's fiscal quarter end, so a fund's report can fall in any month of the quarter)." }, "stakeForms": { "title": "Schedule 13D/13G forms", "type": "array", "description": "stakes13dg only: which forms, e.g. [\"13D\"] for new activist stakes only. Empty = all four for a ticker; 13D and 13D/A for the whole market (activist alerts).", "items": { "type": "string", "enum": [ "13D", "13D/A", "13G", "13G/A" ], "enumTitles": [ "13D (activist, new)", "13D/A (activist, amendment)", "13G (passive, new)", "13G/A (passive, amendment)" ] } }, "minValueUsd": { "title": "Minimum value (USD)", "minimum": 0, "maximum": 1000000000000, "type": "integer", "description": "Minimum value in US dollars, e.g. 1000000. planned144: the notice's aggregate market value; holdings13f/holdingsNport: the position value. Default 0 = no minimum. Not used by stakes13dg.", "default": 0 }, "dateFrom": { "title": "Filed on or after", "pattern": "^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$", "type": "string", "description": "stakes13dg / planned144: earliest filing date, YYYY-MM-DD, e.g. \"2026-10-01\". Structured 13D/13G start 2024-12-18. Empty = `lookbackDays` before today." }, "dateTo": { "title": "Filed on or before", "pattern": "^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$", "type": "string", "description": "stakes13dg / planned144: latest filing date, YYYY-MM-DD, e.g. \"2026-10-31\". Empty = today, including today's filings from the EDGAR live feed." }, "lookbackDays": { "title": "Days back (when no start date)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "stakes13dg / planned144, used when `dateFrom` is empty: filings from this many days back until today, e.g. 30. Empty = 365 days for a ticker's 13D/13G, 90 for a ticker's Form 144, 7 for the whole market." }, "maxResults": { "title": "Max rows", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum rows (one charged event each), e.g. 200. Default 50: a fund's largest positions, a stock's largest holders, or the newest filings.", "default": 50 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }