{ "openapi": "3.0.1", "info": { "title": "SEC Filings Scraper — EDGAR 8-K, 10-K & Earnings Feed", "description": "SEC EDGAR filings as a clean, typed feed: 8-K material events with the Ex-99.1 earnings press release, 10-K / 10-Q risk factors and MD&A, S-1, Form 4 insider trades, 13D/G stakes — one row per filing, verbatim section text, optional XBRL financials, new-since-last-run delta.", "version": "0.1", "x-build-id": "6fMqZXqRHEvOjtJHc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/inovaflow~sec-filings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-inovaflow-sec-filings-scraper", "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/inovaflow~sec-filings-scraper/runs": { "post": { "operationId": "runs-sync-inovaflow-sec-filings-scraper", "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/inovaflow~sec-filings-scraper/run-sync": { "post": { "operationId": "run-sync-inovaflow-sec-filings-scraper", "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, CIKs or names)", "type": "array", "description": "One per line: a ticker (`AAPL`), a CIK (`320193`) or a registrant name (`Microsoft`). Names are matched against SEC's official ticker list; a name that fits several registrants is not guessed — the run summary lists the candidates. Leave empty for market-wide discovery.", "items": { "type": "string" } }, "formTypes": { "title": "Form types", "uniqueItems": true, "type": "array", "description": "Which filings to return. Amendments (8-K/A, 10-K/A…) are included with their form unless you switch them off under Limits.", "items": { "type": "string", "enum": [ "8-K", "10-K", "10-Q", "20-F", "6-K", "S-1", "4", "SCHEDULE 13D", "SCHEDULE 13G", "DEF 14A" ], "enumTitles": [ "8-K — current report: material events, earnings (Item 2.02), exec changes (5.02), deals (1.01)", "10-K — annual report: business, risk factors, MD&A", "10-Q — quarterly report: MD&A, risk-factor updates", "20-F — annual report of a foreign private issuer", "6-K — current report of a foreign private issuer", "S-1 — IPO / registration statement", "Form 4 — insider buys, sells and grants", "Schedule 13D — activist / >5% stake with intent", "Schedule 13G — passive >5% stake", "DEF 14A — proxy statement" ] }, "default": [ "8-K", "10-K", "10-Q" ] }, "filedWithinDays": { "title": "Filed within (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "How far back to look, counting today. 90 days covers one full earnings cycle (one 10-Q or 10-K plus the earnings 8-K per company).", "default": 90 }, "items8K": { "title": "8-K items (optional)", "uniqueItems": true, "type": "array", "description": "Only return 8-Ks that report one of these items — e.g. 2.02 for earnings, 5.02 for executive and board changes, 1.01 for material agreements. Empty = every 8-K. Other form types are not affected.", "items": { "type": "string", "enum": [ "1.01", "1.02", "1.03", "1.04", "1.05", "2.01", "2.02", "2.03", "2.04", "2.05", "2.06", "3.01", "3.02", "3.03", "4.01", "4.02", "5.01", "5.02", "5.03", "5.04", "5.05", "5.06", "5.07", "5.08", "6.01", "6.02", "6.03", "6.04", "6.05", "7.01", "8.01", "9.01" ], "enumTitles": [ "1.01 — Entry into a Material Definitive Agreement", "1.02 — Termination of a Material Definitive Agreement", "1.03 — Bankruptcy or Receivership", "1.04 — Mine Safety - Reporting of Shutdowns and Patterns of Violations", "1.05 — Material Cybersecurity Incidents", "2.01 — Completion of Acquisition or Disposition of Assets", "2.02 — Results of Operations and Financial Condition", "2.03 — Creation of a Direct Financial Obligation or an Obligation under an Off-Balance Sheet Arrangement of a Registrant", "2.04 — Triggering Events That Accelerate or Increase a Direct Financial Obligation or an Obligation under an Off-Balance Sheet Arrangement", "2.05 — Costs Associated with Exit or Disposal Activities", "2.06 — Material Impairments", "3.01 — Notice of Delisting or Failure to Satisfy a Continued Listing Rule or Standard; Transfer of Listing", "3.02 — Unregistered Sales of Equity Securities", "3.03 — Material Modification to Rights of Security Holders", "4.01 — Changes in Registrant's Certifying Accountant", "4.02 — Non-Reliance on Previously Issued Financial Statements or a Related Audit Report or Completed Interim Review", "5.01 — Changes in Control of Registrant", "5.02 — Departure of Directors or Certain Officers; Election of Directors; Appointment of Certain Officers: Compensatory Arrangements of Certain Officers", "5.03 — Amendments to Articles of Incorporation or Bylaws; Change in Fiscal Year", "5.04 — Temporary Suspension of Trading Under Registrant's Employee Benefit Plans", "5.05 — Amendments to the Registrant's Code of Ethics, or Waiver of a Provision of the Code of Ethics", "5.06 — Change in Shell Company Status", "5.07 — Submission of Matters to a Vote of Security Holders", "5.08 — Shareholder Director Nominations", "6.01 — ABS Informational and Computational Material", "6.02 — Change of Servicer or Trustee", "6.03 — Change in Credit Enhancement or Other External Support", "6.04 — Failure to Make a Required Distribution", "6.05 — Securities Act Updating Disclosure", "7.01 — Regulation FD Disclosure", "8.01 — Other Events", "9.01 — Financial Statements and Exhibits" ] }, "default": [] }, "searchQuery": { "title": "Full-text phrase (optional)", "type": "string", "description": "Only filings whose text contains this phrase (EDGAR full-text search). Use quotes for an exact phrase: `\"artificial intelligence\"`, `\"going concern\"`, `tariff`. Works market-wide or restricted to the companies above." }, "extractSections": { "title": "Extract key sections (verbatim)", "type": "boolean", "description": "Copy the key sections into the row, word for word: each 8-K item, the Ex-99.1 earnings press release, 10-K Items 1 / 1A / 1C / 7 / 7A, 10-Q MD&A and risk factors, 20-F Items 3–5, S-1 summary / risk factors / use of proceeds, 13D purpose of transaction. Off = metadata, Form 4 trades and 13D/G holders only (faster).", "default": true }, "maxCharsPerSection": { "title": "Max characters per section", "minimum": 500, "maximum": 500000, "type": "integer", "description": "Long sections (a 10-K's risk factors run to 60,000+ characters) are cut at this length on a line boundary; the row says the full length and that it was cut.", "default": 20000 }, "includeExhibits": { "title": "Include Ex-99 exhibits (earnings press releases)", "type": "boolean", "description": "For 8-K and 6-K filings, also copy the Ex-99 exhibits — the earnings press release of an Item 2.02 8-K, investor presentations, deal announcements.", "default": true }, "includeXbrlFacts": { "title": "Include XBRL financial facts", "type": "boolean", "description": "For 10-K, 10-Q and 20-F rows, add the headline financials the filing reported for its own period — revenue, net income, EPS, assets, cash, operating cash flow… — straight from SEC's XBRL data, with unit and period. One extra request per company.", "default": false }, "onlyNewSinceLastRun": { "title": "Only filings new since the last run", "type": "boolean", "description": "Skip every filing this watch has delivered before (matched on the accession number, EDGAR's permanent filing ID). The first run is the baseline and returns everything in the window. Skipped filings are never charged.", "default": false }, "watchId": { "title": "Watch ID", "type": "string", "description": "Name of this watch's memory. Use a different ID per schedule (e.g. `portfolio-8k`, `ai-ipo-watch`) so two schedules don't share what they've seen.", "default": "default" }, "maxResults": { "title": "Max filings", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Most filings to return in one run, newest first. You are charged per filing delivered.", "default": 50 }, "maxFilingsPerCompany": { "title": "Max filings per company", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Keeps one prolific filer from filling the whole run.", "default": 25 }, "includeAmendments": { "title": "Include amendments (/A)", "type": "boolean", "description": "Return amended filings (8-K/A, 10-K/A, SCHEDULE 13D/A…) together with originals. Every row says whether it is an amendment.", "default": true }, "periodicSections": { "title": "Periodic-report sections", "uniqueItems": true, "type": "array", "description": "Which 10-K / 10-Q / 20-F items to copy. Empty = all of them.", "items": { "type": "string", "enum": [ "10-K:1", "10-K:1A", "10-K:1C", "10-K:7", "10-K:7A", "10-Q:I-2", "10-Q:I-3", "10-Q:II-1A", "20-F:3", "20-F:4", "20-F:5" ], "enumTitles": [ "10-K Item 1 Business", "10-K Item 1A Risk Factors", "10-K Item 1C Cybersecurity", "10-K Item 7 MD&A", "10-K Item 7A Market Risk", "10-Q Part I Item 2 MD&A", "10-Q Part I Item 3 Market Risk", "10-Q Part II Item 1A Risk Factors", "20-F Item 3 Key Information (Risk Factors)", "20-F Item 4 Information on the Company", "20-F Item 5 Operating and Financial Review" ] }, "default": [] }, "maxExhibitsPerFiling": { "title": "Max Ex-99 exhibits per filing", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many Ex-99 exhibits to copy from one 8-K / 6-K (Ex-99.1, Ex-99.2…).", "default": 3 }, "requestsPerSecond": { "title": "Requests per second to SEC", "minimum": 1, "maximum": 10, "type": "integer", "description": "SEC allows at most 10 requests per second; the default of 8 leaves headroom. Lower it if you run several copies at once.", "default": 8 }, "maxConcurrency": { "title": "Filings read in parallel", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many filings are read at the same time (all requests share the per-second limit above).", "default": 4 } } }, "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 } } } } } } } } } }