{ "openapi": "3.0.1", "info": { "title": "SEC EDGAR Filings Monitor: 8-K, 10-K, 10-Q, 13F by Ticker", "description": "Monitor SEC EDGAR filings (8-K, 10-K, 10-Q, 13F, S-1 and more) for any list of tickers or CIKs. Returns new and changed filings with document URLs, dates and 8-K item codes from the official SEC submissions API. No login, no proxies.", "version": "0.1", "x-build-id": "eNBgoe1YfRP7ImhsM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ailu_studio~sec-edgar-filings-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ailu_studio-sec-edgar-filings-monitor", "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/ailu_studio~sec-edgar-filings-monitor/runs": { "post": { "operationId": "runs-sync-ailu_studio-sec-edgar-filings-monitor", "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/ailu_studio~sec-edgar-filings-monitor/run-sync": { "post": { "operationId": "run-sync-ailu_studio-sec-edgar-filings-monitor", "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": { "companies": { "title": "Companies (tickers or CIK numbers)", "type": "array", "description": "Stock tickers (e.g. \"AAPL\", \"BRK-B\") or SEC CIK numbers (e.g. \"320193\" or \"CIK0000320193\"). Tickers are resolved through the official SEC ticker list; use the CIK for companies without a ticker (funds, private filers).", "default": [ "AAPL", "MSFT", "NVDA" ], "items": { "type": "string" } }, "forms": { "title": "Form types", "type": "array", "description": "Only return these SEC form types, e.g. [\"8-K\", \"10-K\", \"10-Q\"], [\"13F-HR\"], [\"4\"], [\"S-1\"], [\"DEF 14A\"]. Exact match, case-insensitive. Leave empty to return every form type.", "default": [ "8-K", "10-K", "10-Q" ], "items": { "type": "string" } }, "includeAmendments": { "title": "Include amendments (form/A)", "type": "boolean", "description": "When true (default), amended filings such as 10-K/A or 8-K/A are returned together with the form they amend. Set false to skip all amendments.", "default": true }, "sinceDays": { "title": "Look-back window (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only filings with a filing date within the last N days (default 90). 0 disables the date filter. Only the latest ~1,000 filings per company (the SEC 'recent' block) are checked, so very old filings are never returned.", "default": 90 }, "outputMode": { "title": "What to return", "enum": [ "all", "changes", "new" ], "type": "string", "description": "\"all\" (default) returns every filing that matches the filters, each tagged with changeType. \"changes\" returns only filings that are new or changed since the previous run with the same stateStoreName; \"new\" returns only never-seen filings. On the first run every filing counts as new.", "default": "all" }, "stateStoreName": { "title": "Watchlist memory name", "type": "string", "description": "Name of the key-value store that remembers which filings were seen; change detection compares against it. Use one name per watchlist (e.g. \"portfolio-13f\"). A new name starts fresh, so its first run reports every filing as new. Default \"sec-edgar-state\".", "default": "sec-edgar-state" }, "maxItems": { "title": "Maximum rows to return", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Upper limit on returned rows for this run (default 200). Rows are sorted newest first across all companies before the limit is applied, so the newest filings are kept. Filings beyond the limit are still recorded as seen.", "default": 200 } } }, "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 } } } } } } } } } }