{
"openapi": "3.0.1",
"info": {
"title": "SEC EDGAR Scraper ยท Filings, Financials & Full-Text Search",
"description": "SEC EDGAR Scraper extracts SEC filings (10-K, 10-Q, 8-K, Form 4 insider trades, 13F holdings, 13D/G, S-1) by ticker, CIK, or SIC code with full-text search and XBRL financial statements.",
"version": "0.1",
"x-build-id": "3brn3eEEt2PbbAjCO"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/reapx~sec-edgar-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-reapx-sec-edgar-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/reapx~sec-edgar-scraper/runs": {
"post": {
"operationId": "runs-sync-reapx-sec-edgar-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/reapx~sec-edgar-scraper/run-sync": {
"post": {
"operationId": "run-sync-reapx-sec-edgar-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 or CIK numbers)",
"type": "array",
"description": "One ticker or CIK per line, for example AAPL, MSFT, or 0000320193. Leave empty if you are searching by industry code or by full text instead.",
"items": {
"type": "string"
}
},
"fullTextQuery": {
"title": "Full-text search",
"type": "string",
"description": "Search the text of filings themselves. Wrap a phrase in double quotes to match it exactly, for example \"material weakness\". Covers filings from 2001 onward.
Leave this field empty to skip this filter."
},
"sic": {
"title": "SIC industry code",
"type": "string",
"description": "Return filings from every company in one industry. For example 2836 is biological products, 6798 is REITs, 7372 is prepackaged software.
Leave this field empty to skip this filter."
},
"formTypes": {
"title": "Form types",
"type": "array",
"description": "Which filings to return. Selecting a form also returns its amendments, so 10-K includes 10-K/A. Leave empty to get annual, quarterly and current reports.",
"items": {
"type": "string",
"enum": [
"10-K",
"10-Q",
"8-K",
"20-F",
"40-F",
"S-1",
"S-3",
"S-4",
"DEF 14A",
"13F-HR",
"SC 13D",
"SC 13G",
"4",
"3",
"5",
"424B4",
"6-K",
"11-K",
"SD",
"N-CSR"
],
"enumTitles": [
"10-K - annual report",
"10-Q - quarterly report",
"8-K - current report",
"20-F - foreign annual report",
"40-F - Canadian annual report",
"S-1 - IPO registration",
"S-3 - shelf registration",
"S-4 - merger registration",
"DEF 14A - proxy statement",
"13F-HR - institutional holdings",
"SC 13D - activist stake",
"SC 13G - passive stake",
"4 - insider transaction",
"3 - initial insider ownership",
"5 - annual insider statement",
"424B4 - IPO prospectus",
"6-K - foreign current report",
"11-K - employee benefit plan",
"SD - conflict minerals",
"N-CSR - fund annual report"
]
}
},
"filedFrom": {
"title": "Filed on or after",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string",
"description": "Earliest filing date to return, as YYYY-MM-DD."
},
"filedTo": {
"title": "Filed on or before",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string",
"description": "Latest filing date to return, as YYYY-MM-DD. Leave empty for today."
},
"stateOfIncorporation": {
"title": "State of incorporation",
"type": "string",
"description": "Two-letter code, for example DE for Delaware or NY for New York. Filters companies by where they are incorporated, not where they operate.
Leave this field empty to skip this filter."
},
"includeFinancials": {
"title": "Attach key financials",
"type": "boolean",
"description": "Add the latest reported revenue, net income, assets, liabilities, equity, operating income, cash and diluted EPS to every row, taken from the company's own XBRL data. Adds roughly eight extra requests per company.",
"default": false
},
"includeFilingHistory": {
"title": "Search the full filing history",
"type": "boolean",
"description": "By default only the most recent 1,000 filings per company are searched, which covers several years for most companies. Turn this on to search everything back to 1994.",
"default": false
},
"maxFilings": {
"title": "Maximum filings to return",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Hard ceiling on the rows this run produces, and therefore on what it costs. You are charged per filing returned.
The higher the number, the longer the run takes and the more you are charged, because you pay per row returned.",
"default": 50
},
"maxFilingsPerCompany": {
"title": "Maximum filings per company",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Spreads the result set across companies instead of exhausting the first one. Leave empty for no per-company limit.
The higher the number, the longer the run takes and the more you are charged, because you pay per row returned."
},
"requestsPerSecond": {
"title": "Requests per second",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Politeness against sec.gov, which permits at most 10 per second. Lower this if you see the source refusing requests.",
"default": 8
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}