{ "openapi": "3.0.1", "info": { "title": "SEC Filings Scraper: 10-K, 8-K, Full-Text Search", "description": "Pull SEC filings by ticker, CIK, form, date or EDGAR full-text search past its 10,000 hit cap, no login or API key: 1,000 filings in 15 seconds. Rows hold form, filed and accepted time, period, 8-K items, documents, company profile; text and XBRL figures as add-ons. JSON or CSV, pay per filing.", "version": "0.1", "x-build-id": "lpGE6o1zVC2Ka5Zcm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation_craft~sec-filings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation_craft-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/automation_craft~sec-filings-scraper/runs": { "post": { "operationId": "runs-sync-automation_craft-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/automation_craft~sec-filings-scraper/run-sync": { "post": { "operationId": "run-sync-automation_craft-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": { "tickers": { "title": "Tickers", "type": "array", "description": "Stock ticker symbols of listed companies, for example AAPL, MSFT or BRK-B (BRK.B is read as BRK-B). Each is matched to its company through the SEC's list of listed tickers; a ticker the SEC does not list gets a free status row. Every filing of the company is read, newest first, from its filer record.", "items": { "type": "string" } }, "ciks": { "title": "CIK numbers", "type": "array", "description": "SEC Central Index Keys (CIK) of companies, funds or people, with or without leading zeros (320193 or 0000320193), or an EDGAR company link. Use a CIK for any filer that has no ticker. A CIK the SEC does not know gets a free status row.", "items": { "type": "string" } }, "companyNames": { "title": "Company names", "type": "array", "description": "Names of listed companies, for example Apple Inc. A name is used only when exactly one listed company carries it (letters and digits compared; case, punctuation and spacing aside). Otherwise a free status row lists the nearest listed names, so you can run again with a ticker or CIK. For a company that is not listed, use its CIK. Given as one text instead of a list, put one name per line (a name can hold commas).", "items": { "type": "string" } }, "accessionNumbers": { "title": "Accession numbers or filing links", "type": "array", "description": "Filings to read as asked, by accession number (0000320193-26-000011) or EDGAR filing link. A bare accession number is looked up under the CIK its first ten digits name, which is the filer's own CIK when the company filed for itself; for a filing an agent filed, paste its EDGAR link. Filters do not apply to these. Cannot be combined with companies or searches.", "items": { "type": "string" } }, "searchQueries": { "title": "Full-text search queries", "type": "array", "description": "Words or exact phrases to find in the text of filings, written as on the SEC's full-text search: \"exact phrase\" in quotes, OR between alternatives, a leading minus to exclude a word. One row per matching filing (newest first), with the documents that matched. A filing that several queries or presets find is one row that lists every one of them (matchedQueries), charged once. Narrow a search with tickers or CIKs, form types and dates. The full-text search covers filings from 2001 on. Given as one text instead of a list, put one query per line (a query can hold commas).", "items": { "type": "string" } }, "searchPresets": { "title": "Ready-made searches", "type": "array", "description": "Named full-text searches, run like searchQueries: going concern, material weakness, restatement, cybersecurity incident, layoffs, guidance withdrawn, CEO departure, bankruptcy (chapter 11), share buyback, activist investor, artificial intelligence, tariffs.", "items": { "type": "string", "enum": [ "going_concern", "material_weakness", "restatement", "cybersecurity_incident", "layoffs", "guidance_withdrawn", "ceo_departure", "bankruptcy", "share_buyback", "activist_investor", "artificial_intelligence", "tariffs" ], "enumTitles": [ "\"going concern\"", "\"material weakness\"", "\"restatement\" OR \"restated\"", "\"cybersecurity incident\"", "\"reduction in force\" OR \"workforce reduction\"", "\"withdraw\" \"guidance\"", "\"chief executive officer\" \"resign\"", "\"chapter 11\"", "\"share repurchase program\"", "\"activist\"", "\"artificial intelligence\"", "\"tariffs\"" ] } }, "formTypes": { "title": "Form types", "type": "array", "description": "EDGAR form types to keep, for example 10-K, 10-Q, 8-K, 4, S-1, DEF 14A, SC 13D. A form includes its amendments (10-K/A) unless includeAmendments is false; give 10-K/A alone for amendments only. Leave empty for every form type.", "items": { "type": "string", "enumSuggestedValues": [ "10-K", "10-Q", "8-K", "20-F", "40-F", "6-K", "S-1", "S-3", "S-4", "S-8", "F-1", "424B2", "424B4", "424B5", "DEF 14A", "DEFA14A", "PRE 14A", "SC 13D", "SC 13G", "SCHEDULE 13D", "SCHEDULE 13G", "13F-HR", "3", "4", "5", "144", "D", "11-K", "10-K/A", "10-Q/A", "8-K/A", "NT 10-K", "NT 10-Q", "SD", "25-NSE", "15-12B", "8-A12B", "CORRESP", "UPLOAD", "N-CSR", "NPORT-P", "485BPOS", "497K", "ARS" ] } }, "includeAmendments": { "title": "Include amendments", "type": "boolean", "description": "Keep amended filings (form types ending in /A) along with the original form types. True when left empty." }, "dateFrom": { "title": "Filed from", "type": "string", "description": "Keep filings filed on or after this date (YYYY-MM-DD). Left empty: a company's whole history, a search's whole span (2001 on), or the last 7 days when no company, filing or query is given." }, "dateTo": { "title": "Filed until", "type": "string", "description": "Keep filings filed on or before this date (YYYY-MM-DD). Left empty: today." }, "daysBack": { "title": "Days back", "minimum": 0, "maximum": 36500, "type": "integer", "description": "Instead of a start date: keep filings of the last N days, counted from the run's start on the SEC's calendar (US Eastern). 0 means today only. Cannot be combined with dateFrom." }, "items8K": { "title": "8-K item codes", "type": "array", "description": "Keep only filings that report at least one of these Form 8-K items, for example 2.02 (results of operations), 5.02 (officer and director changes) or 1.01 (material agreement). Filings without items (every form but 8-K) are left out when this is set.", "items": { "type": "string", "enumSuggestedValues": [ "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", "6.06", "6.10", "7.01", "8.01", "9.01" ] } }, "eventCategories": { "title": "8-K event categories", "type": "array", "description": "Shortcuts for groups of 8-K items, joined to items8K: earnings, material agreement, mergers and acquisitions, bankruptcy, cybersecurity incident, debt financing, restructuring, delisting, equity sale, auditor change, restatement, leadership change, governance, shareholder vote, Regulation FD, other events.", "items": { "type": "string", "enum": [ "earnings", "material_agreement", "mergers_acquisitions", "bankruptcy", "cybersecurity", "debt_financing", "restructuring", "delisting", "equity_sale", "auditor_change", "restatement", "leadership_change", "governance", "shareholder_vote", "regulation_fd", "other_events" ], "enumTitles": [ "Earnings (2.02)", "Material agreement (1.01, 1.02)", "Mergers and acquisitions (1.01, 2.01, 5.01)", "Bankruptcy (1.03)", "Cybersecurity incident (1.05)", "Debt financing (2.03, 2.04)", "Restructuring and impairments (2.05, 2.06)", "Delisting notice (3.01)", "Equity sale (3.02, 3.03)", "Auditor change (4.01)", "Restatement (4.02)", "Leadership change (5.02)", "Governance (5.03, 5.05, 5.06)", "Shareholder vote (5.07, 5.08)", "Regulation FD (7.01)", "Other events (8.01)" ] } }, "minFilingSizeKb": { "title": "Minimum filing size (KB)", "minimum": 0, "type": "integer", "description": "Keep only filings whose whole submission is at least this many kilobytes. In searches and date windows the size is read from each filing's index page first (slower)." }, "companyNameContains": { "title": "Filer name contains", "type": "string", "description": "Keep only filings where a filer's name contains this text (case and spacing aside), for example \"Bank\" or \"Therapeutics\". For full-text searches and date windows; companies are named by ticker, CIK or name instead." }, "sortBy": { "title": "Search order", "enum": [ "newest", "relevance" ], "type": "string", "description": "Order of full-text search results: newest first (every match, split by date past the search's 10,000 result window), or by relevance (the search's own score; at most 10,000 results). In relevance order several queries are read one after another, so a row names the query that delivered it.", "default": "newest" }, "includeFilingDetails": { "title": "Filing details (free)", "type": "boolean", "description": "Read each filing's index page: every document and exhibit with its type, description and size, every filer with its role (filer, issuer, reporting owner, subject company), and the acceptance time for search and date window rows. Free; one extra request per filing makes a run slower.", "default": false }, "includeDocumentText": { "title": "Document text (paid add-on)", "type": "boolean", "description": "Read the filing's main document into plain text, priced per filing as the Document text event, charged only when the text was read. Adds report sections for 10-K, 10-Q and 20-F (Item 1A Risk Factors, Item 7 MD&A and the rest), item sections for 8-K, the 8-K press release (exhibit 99.1) with its outlook sentences and a finance word count, and the stake of each reporting person on Schedule 13D and 13G. May be left off a row when its allowance is spent; the row then says so.", "default": false }, "maxTextCharacters": { "title": "Text length per document", "minimum": 1000, "maximum": 2000000, "type": "integer", "description": "The most characters of a document's text kept in a row (200,000 when left empty). The full length is reported. Only with includeDocumentText." }, "textChunkSize": { "title": "Text chunks for AI and search (characters)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Also cut the document text into chunks of about this many characters at paragraph or sentence ends, for retrieval and AI pipelines. 0 or empty: no chunks. Only with includeDocumentText." }, "includeFinancialData": { "title": "Financial data (paid add-on)", "type": "boolean", "description": "Attach the XBRL figures a 10-K, 10-Q, 20-F or 40-F reported for its own period: revenue, net income, operating income, earnings per share, assets, liabilities, equity, cash, operating cash flow, long-term debt and shares outstanding (or the concepts you list). Priced per filing as the Financial data event, charged only when at least one figure was found.", "default": false }, "financialConcepts": { "title": "XBRL concepts", "type": "array", "description": "The XBRL concepts to read instead of the default set, for example Revenues, us-gaap:NetIncomeLoss or ifrs-full:Revenue (us-gaap when no taxonomy is named). Only with includeFinancialData.", "items": { "type": "string" } }, "includeCompanyRows": { "title": "Company profile rows (free)", "type": "boolean", "description": "One free row per company read by ticker, CIK or name: name, tickers, exchanges, industry (SIC), state of incorporation, fiscal year end, addresses, phone, former names.", "default": true }, "includePersonalData": { "title": "Include personal data", "type": "boolean", "description": "All public data is always delivered, so this setting has no effect (it is kept so saved inputs keep working).", "default": false }, "maxItems": { "title": "Maximum filings", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most filing rows (charged events) one run delivers. Free status, company and summary rows do not count.", "default": 100 }, "maxFilingsPerCompany": { "title": "Maximum filings per company", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most filings delivered for each company given by ticker, CIK or name, so a list of companies shares the run. Only for companies." }, "maxFilingsPerForm": { "title": "Maximum filings per form type", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most filings delivered of each form type (a form and its amendments count together), for example 5 of each when several form types are asked. Filings past it are skipped free." }, "maxRequestsPerSecond": { "title": "Requests per second", "minimum": 1, "maximum": 5, "type": "integer", "description": "How fast this run asks the SEC (the SEC allows 10 per second per user; this Actor never sends more than 5).", "default": 5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed: the SEC is read from the run's own address, with one Apify datacenter proxy session as an automatic fallback. Turn on Apify Proxy to send every request through that session from the start. Own proxy URLs are not used." } } }, "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 } } } } } } } } } }