{ "openapi": "3.0.1", "info": { "title": "SEC XBRL Financials Scraper — Revenue, Income, Assets", "description": "Get structured financial-statement data — revenue, net income, gross profit, assets, liabilities, equity, EPS, cash flow and more — for any US public company by ticker or CIK. Full historical time series straight from the SEC official XBRL API. No API key, always current.", "version": "0.0", "x-build-id": "CQJIeem2RL7uuomIZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parkero~sec-financials-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parkero-sec-financials-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/parkero~sec-financials-scraper/runs": { "post": { "operationId": "runs-sync-parkero-sec-financials-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/parkero~sec-financials-scraper/run-sync": { "post": { "operationId": "run-sync-parkero-sec-financials-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", "required": [ "tickersOrCiks" ], "properties": { "tickersOrCiks": { "title": "Tickers or CIK Numbers", "type": "array", "description": "One or more ticker symbols (e.g. AAPL, MSFT) or raw SEC CIK numbers (e.g. 320193). Mixed lists are allowed — the actor resolves tickers to CIKs automatically via the official SEC ticker map.", "items": { "type": "string" } }, "concepts": { "title": "XBRL Concepts", "type": "array", "description": "XBRL concept names to extract. Omit to use the default set of 13 fundamental financial concepts (Revenues, NetIncomeLoss, Assets, Liabilities, StockholdersEquity, CashAndCashEquivalentsAtCarryingValue, NetCashProvidedByUsedInOperatingActivities, GrossProfit, OperatingIncomeLoss, EarningsPerShareBasic, EarningsPerShareDiluted, ResearchAndDevelopmentExpense, RevenueFromContractWithCustomerExcludingAssessedTax). Concepts absent for a given company are silently skipped.", "items": { "type": "string" } }, "taxonomy": { "title": "Taxonomy", "type": "string", "description": "Taxonomy to read from the company facts API. Defaults to 'us-gaap' (US Generally Accepted Accounting Principles). Common alternatives: 'dei' (Document Entity Information)." }, "forms": { "title": "Form Types", "type": "array", "description": "Only return facts from these SEC form types. Common values: 10-K (annual report), 10-Q (quarterly report). Leave empty to return facts from all form types.", "items": { "type": "string" } }, "sinceFiscalYear": { "title": "Since Fiscal Year", "minimum": 1900, "type": "integer", "description": "Only return facts where the fiscal year (fy) is greater than or equal to this value. Leave blank for no lower bound. Example: 2020 returns data from fiscal year 2020 onwards." }, "maxPerConcept": { "title": "Max Facts Per Concept Per Company", "minimum": 1, "type": "integer", "description": "Maximum number of datapoints to return per concept per company, applied after all filters. Useful for keeping output sizes manageable when fetching many concepts for many companies. Leave blank for no cap." }, "userAgent": { "title": "SEC User-Agent (Required by SEC policy)", "type": "string", "description": "User-Agent string sent with every request to the SEC API. The SEC's fair-access policy REQUIRES a descriptive User-Agent that identifies your tool and includes a contact email address. Requests without a proper User-Agent are rejected with HTTP 403. Format: 'YourToolName/1.0 contact@yourdomain.com'. See https://www.sec.gov/os/webmaster-faq#developers" } } }, "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 } } } } } } } } } }