# SEC EDGAR US Company Filings & Financial Facts Scraper (`dromb/sec-edgar-us`) Actor Search SEC EDGAR companies, browse by exchange, and extract company profiles with recent filings and XBRL financial facts. - **URL**: https://apify.com/dromb/sec-edgar-us.md - **Developed by:** [Dmitriy Gyrbu](https://apify.com/dromb) (community) - **Categories:** Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## SEC EDGAR US Company Filings & Financial Facts Scraper Detailed scraper for the US Securities and Exchange Commission (SEC) EDGAR system. This actor allows you to discover public companies, browse them by exchange, and extract detailed company profiles including recent filings and key XBRL financial facts. This actor is unofficial and is not affiliated with, endorsed by, or sponsored by the US Securities and Exchange Commission. ### Endpoints #### Search **Description:** Searches SEC company records by company name, ticker, or keyword and returns matching companies. **Why you need it:** You often know a company name or ticker but need the correct SEC identifiers (CIK) and structured company metadata before pulling filings or financial facts. **Example use:** Search for "Apple" or "Apple Hospitality". **Customer value:** Useful for company discovery, ticker enrichment, lead lists, compliance research, investment screening, and building datasets of public companies. #### Category / Categories **Description:** Lists or browses companies by category-like grouping, such as exchange or available company collections. **Why you need it:** You may not want to search one company at a time. You may need to browse a segment of companies and build a structured dataset from a known group. **Example use:** Browse companies listed on Nasdaq (use `category_id: "exchange:Nasdaq"`). **Customer value:** Useful for market mapping, exchange-based datasets, bulk enrichment workflows, and discovering companies without manually preparing search queries. #### Item / Detail **Description:** Fetches a detailed SEC company profile by ticker, CIK, or company identifier, including filings and financial facts where available. **Why you need it:** This is the high-value endpoint. Use it when you need full company-level SEC data, not just a search result. **Example use:** Get details for `ticker: "AAPL"` or `cik: "0000320193"`. **Customer value:** Useful for due diligence, compliance checks, financial research, company intelligence, and automated enrichment of internal company databases. ### Input Schema - `query`: Search term (Name, Ticker, CIK). - `exchange`: Filter results by exchange (e.g., Nasdaq, NYSE). - `category_id`: Browse by category (e.g., `exchange:Nasdaq`). - `cik`: Specific 10-digit CIK for detailed profile. - `ticker`: Specific ticker symbol for detailed profile. - `item_id`: Alias for CIK or Ticker. - `filings_limit`: Number of recent filings to return (default: 20). - `include_facts`: Include summary XBRL financial facts (default: true). - `page`: Results page (default: 1). - `limit`: Results per page (default: 25). ### Example Inputs Probe: ```json {} ```` Search for Apple: ```json { "query": "Apple", "limit": 5 } ``` Browse Nasdaq: ```json { "category_id": "exchange:Nasdaq", "limit": 25 } ``` Get Apple Inc. details: ```json { "ticker": "AAPL", "filings_limit": 10, "include_facts": true } ``` ### Output Fields Search and category records include `id`, `item_id`, `cik`, `ticker`, `name`, `exchange`, `category_id`, `source_url`, and `source`. Item detail records additionally include company metadata, mailing and business addresses, recent filings with direct SEC archive URLs, filing metadata, selected `facts_summary` financial metrics, and source URLs for SEC submissions, company facts, and profile pages. ### Limitations - The actor depends on the official SEC.gov API. - Rate limits are handled by the SEC's User-Agent requirements; however, extremely high concurrency may still be subject to SEC's fairness policy. - Financial facts are extracted from the most recent available XBRL filings and may vary based on the company's reporting standard. # Actor input Schema ## `query` (type: `string`): Company name, ticker, or CIK to search for. ## `exchange` (type: `string`): Optional exact exchange filter (e.g., Nasdaq, NYSE). ## `category_id` (type: `string`): Exchange category ID (e.g., exchange:Nasdaq) for browsing. ## `cik` (type: `string`): Specific 10-digit CIK for detailed profile extraction. ## `ticker` (type: `string`): Specific ticker symbol for detailed profile extraction. ## `item_id` (type: `string`): Alias of CIK or Ticker for detailed profile extraction. ## `filings_limit` (type: `integer`): Number of recent filings to return. ## `include_facts` (type: `boolean`): Include summary XBRL financial facts. ## `page` (type: `integer`): 1-based results page. ## `limit` (type: `integer`): Number of results per page. ## Actor input object example ```json { "filings_limit": 20, "include_facts": true, "page": 1, "limit": 25 } ``` # Actor output Schema ## `results` (type: `string`): Company metadata, company listing, or detailed profile dataset items. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("dromb/sec-edgar-us").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("dromb/sec-edgar-us").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call dromb/sec-edgar-us --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dromb/sec-edgar-us", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC EDGAR US Company Filings & Financial Facts Scraper", "description": "Search SEC EDGAR companies, browse by exchange, and extract company profiles with recent filings and XBRL financial facts.", "version": "0.2", "x-build-id": "dAe7FWDGWPd52pnnu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dromb~sec-edgar-us/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dromb-sec-edgar-us", "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/dromb~sec-edgar-us/runs": { "post": { "operationId": "runs-sync-dromb-sec-edgar-us", "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/dromb~sec-edgar-us/run-sync": { "post": { "operationId": "run-sync-dromb-sec-edgar-us", "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": { "query": { "title": "Query", "type": "string", "description": "Company name, ticker, or CIK to search for." }, "exchange": { "title": "Exchange", "type": "string", "description": "Optional exact exchange filter (e.g., Nasdaq, NYSE)." }, "category_id": { "title": "Category ID", "type": "string", "description": "Exchange category ID (e.g., exchange:Nasdaq) for browsing." }, "cik": { "title": "CIK", "type": "string", "description": "Specific 10-digit CIK for detailed profile extraction." }, "ticker": { "title": "Ticker", "type": "string", "description": "Specific ticker symbol for detailed profile extraction." }, "item_id": { "title": "Item ID", "type": "string", "description": "Alias of CIK or Ticker for detailed profile extraction." }, "filings_limit": { "title": "Filings Limit", "type": "integer", "description": "Number of recent filings to return.", "default": 20 }, "include_facts": { "title": "Include Facts", "type": "boolean", "description": "Include summary XBRL financial facts.", "default": true }, "page": { "title": "Page", "type": "integer", "description": "1-based results page.", "default": 1 }, "limit": { "title": "Limit", "type": "integer", "description": "Number of results per page.", "default": 25 } } }, "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 } } } } } } } } } } ```