{
"openapi": "3.0.1",
"info": {
"title": "SEC EDGAR Scraper - Filings, Financials, Insider Trades, 13F",
"description": "Scrape SEC EDGAR: company filings and profiles, financial statements (revenue, profit, cash flow, EPS), insider trades (Form 4), 13F holdings with quarterly changes, Form D private placements, full-text search and the earnings calendar. By ticker, CIK or keyword. Made by ScraperCompany.",
"version": "1.0",
"x-build-id": "UGuzdYGFhJmROwbRe"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapercompany~sec-edgar-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapercompany-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/scrapercompany~sec-edgar-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapercompany-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/scrapercompany~sec-edgar-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapercompany-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": {
"mode": {
"title": "What to get",
"enum": [
"filings",
"financials",
"insider_trades",
"holdings",
"private_placements",
"search",
"companies",
"earnings_calendar"
],
"type": "string",
"description": "The SEC EDGAR data to fetch. Each line of Items is one request.",
"default": "filings"
},
"items": {
"title": "Items",
"type": "array",
"description": "One per line. Filings, financials, insider trades: a ticker or CIK (AAPL, 0000320193). 13F holdings: the manager's ticker or CIK (BRK-B, 0001067983). Private placements, full-text search, find companies: a keyword or name. Earnings calendar: a day (2026-11-04).",
"default": [
"AAPL"
],
"items": {
"type": "string"
}
},
"forms": {
"title": "Form types",
"type": "array",
"description": "Only these forms, e.g. 10-K, 10-Q, 8-K, S-1 (filings and full-text search).",
"items": {
"type": "string"
}
},
"since": {
"title": "Since",
"type": "string",
"description": "Earliest date, YYYY-MM-DD (filings, insider trades, private placements, search)."
},
"until": {
"title": "Until",
"type": "string",
"description": "Latest date, YYYY-MM-DD (filings, private placements, search)."
},
"limit": {
"title": "Results per request",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Most results per request. Each mode has its own maximum (filings 200, financials 40 periods, insider trades 40 filings, holdings 1,000, private placements 50, companies 25, earnings 1,000); a larger value is lowered to it. Leave empty for the default."
},
"financials_period": {
"title": "Financial periods",
"enum": [
"annual",
"quarterly",
"all"
],
"type": "string",
"description": "Annual (10-K), quarterly (10-Q) or all periods (financials).",
"default": "annual"
},
"concepts": {
"title": "Extra XBRL concepts",
"type": "array",
"description": "Additional us-gaap concepts to return, e.g. us-gaap:Goodwill (financials).",
"items": {
"type": "string"
}
},
"codes": {
"title": "Transaction codes",
"type": "array",
"description": "Only these Form 4 codes, e.g. P (open-market buy), S (sale), A (grant), M (option exercise) (insider trades).",
"items": {
"type": "string"
}
},
"holdings_period": {
"title": "13F quarter",
"type": "string",
"description": "Quarter end, YYYY-MM-DD (e.g. 2026-06-30). Leave empty for the latest filing (13F holdings)."
},
"compare": {
"title": "Compare with previous quarter",
"type": "boolean",
"description": "Add each position's change and the positions sold out since the previous 13F (13F holdings).",
"default": false
},
"industry": {
"title": "Industry",
"type": "string",
"description": "Form D industry group, e.g. Other Technology, Biotechnology (private placements)."
},
"include_amendments": {
"title": "Include amendments",
"type": "boolean",
"description": "Also return amended Form D filings (D/A) (private placements).",
"default": false
},
"page": {
"title": "Search page",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "Results page of full-text search (100 hits per page).",
"default": 1
},
"customRequests": {
"title": "Custom requests (advanced)",
"type": "array",
"description": "Optional list of JSON objects, one request each, using the field names shown above. Each object is merged over the options above, so you only need to give what differs. Use \"mode\" to pick what to fetch per object, with that mode's API fields (company, query or day). Example: {\"mode\":\"insider_trades\",\"company\":\"NVDA\",\"codes\":[\"P\",\"S\"],\"since\":\"2026-01-01\"}"
},
"includeErrors": {
"title": "Include failed requests in the dataset",
"type": "boolean",
"description": "When on, a request that fails (for example an unknown property id) is saved as a dataset item with an error message so you can see what went wrong. Failed requests are never charged.",
"default": true
},
"maxConcurrency": {
"title": "Parallel requests",
"minimum": 1,
"maximum": 8,
"type": "integer",
"description": "How many requests run at the same time (1-8). Parallel runs share one limit, so extra requests wait for a free slot instead of failing.",
"default": 3
},
"maxRetries": {
"title": "Retries per request",
"minimum": 0,
"maximum": 5,
"type": "integer",
"description": "How many times a request that failed for a temporary reason is tried again. Invalid input is never retried.",
"default": 2
}
}
},
"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
}
}
}
}
}
}
}
}
}
}