# Sec Edgar Filings Search (`vivid_astronaut/sec-edgar-filings-search`) Actor

Search SEC EDGAR filings in real time, monitor new disclosures, and extract normalized Form D startup funding leads from official public data. Full-text search, company filings by CIK or ticker, clean JSON output.

- **URL**: https://apify.com/vivid\_astronaut/sec-edgar-filings-search.md
- **Developed by:** [Fabio Suizu](https://apify.com/vivid_astronaut) (community)
- **Categories:** Lead generation, Automation
- **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. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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 Filings Search & Form D Funding Leads

SEC EDGAR Filings Search & Form D Funding Leads turns official SEC public filings into a clean Apify dataset for sales, research, compliance, and market monitoring workflows. It supports two primary data paths: EDGAR full-text filing search and company submissions lookup by CIK or ticker. The default run searches recent Form D filings, which are commonly used as signals for startup fundraising, private placements, venture activity, and emerging issuer discovery.

The Actor uses only official SEC endpoints and does not require an API key. It sends the SEC-required `User-Agent` header, applies a conservative request throttle below the SEC fair access ceiling, and normalizes filings into a predictable schema. Instead of making users parse EDGAR response shapes, parallel arrays, accession numbers, or archive URL rules, each result is pushed as one row with company, form, filing date, accession number, and a direct SEC archive document URL.

### What it does

In `search` mode, the Actor calls the SEC EDGAR full-text search endpoint and returns normalized filing hits. You can search for terms such as `artificial intelligence`, `Series Seed`, `cybersecurity`, `oil and gas`, or a company name, then limit the result set to forms such as `D`, `D/A`, `10-K`, `10-Q`, `8-K`, or `S-1`. Date filters use `YYYY-MM-DD` and are passed to the official SEC endpoint.

In `company` mode, the Actor calls the SEC submissions feed for a single company. You can provide a CIK directly or provide a ticker and let the Actor resolve it through the official SEC ticker mapping. Company submissions are returned from the SEC columnar `filings.recent` structure as normal rows, with optional form filtering.

In `monitor` mode, the Actor runs the same search as `search` mode but emits only filings whose accession numbers have not been seen in prior runs of the Actor storage. This is useful for scheduled lead generation, disclosure alerts, compliance monitoring, and recurring research feeds.

### Use cases

**Funding leads:** Search Form D and Form D/A filings to discover issuers raising capital. Sales teams, data vendors, recruiters, accountants, law firms, and investor relations teams can monitor new private placement activity and enrich the results in their own CRM or warehouse.

**Compliance monitoring:** Track new 8-K, 10-K, 10-Q, S-1, or Form D filings that mention specific risk terms, industries, subsidiaries, geographies, products, or counterparties.

**Company research:** Pull recent filings for a public company by CIK or ticker and export a clean dataset instead of manually browsing EDGAR.

**Market mapping:** Build recurring datasets for themes such as AI startups, climate technology, biotech, fintech, crypto, defense, logistics, or real estate offerings.

**Data pipelines:** Use Apify schedules, webhooks, integrations, and dataset exports to feed filings into Google Sheets, BigQuery, Snowflake, S3, or downstream enrichment systems.

### Input example

```json
{
  "mode": "search",
  "query": "artificial intelligence",
  "forms": ["D"],
  "startDate": "2026-06-01",
  "endDate": "2026-06-30",
  "maxResults": 100,
  "userAgent": "Example Data Team contact@example.com"
}
````

Company lookup example:

```json
{
  "mode": "company",
  "ticker": "AAPL",
  "forms": ["10-K"],
  "maxResults": 25,
  "userAgent": "Example Data Team contact@example.com"
}
```

Monitor example:

```json
{
  "mode": "monitor",
  "query": "Series Seed",
  "forms": ["D"],
  "startDate": "2026-07-01",
  "endDate": "2026-07-06",
  "maxResults": 100,
  "userAgent": "Example Data Team contact@example.com"
}
```

### Output fields

| Field | Description |
| --- | --- |
| `cik` | SEC Central Index Key, padded to 10 digits. |
| `companyName` | Company or issuer name from the SEC response. |
| `formType` | Filing form type such as `D`, `D/A`, `10-K`, or `8-K`. |
| `filedAt` | Filing date in `YYYY-MM-DD` format when provided by SEC. |
| `accessionNo` | SEC accession number with hyphens. |
| `primaryDoc` | Primary document filename for company submissions. Present in company mode. |
| `fileUrl` | Direct SEC Archives URL for the primary filing document. |
| `snippet` | Search snippet or display text for full-text search results. Present in search results when available. |

Search output example:

```json
{
  "cik": "0001817251",
  "companyName": "EquityZen Thematic Fund LLC - AI & Machine Learning Series 2",
  "formType": "D/A",
  "filedAt": "2020-08-05",
  "accessionNo": "0001801154-20-000002",
  "fileUrl": "https://www.sec.gov/Archives/edgar/data/1817251/000180115420000002/primary_doc.xml",
  "snippet": "EquityZen Thematic Fund LLC - AI & Machine Learning Series 2  (CIK 0001817251)"
}
```

Company output example:

```json
{
  "cik": "0000320193",
  "companyName": "Apple Inc.",
  "formType": "10-K",
  "filedAt": "2025-10-31",
  "accessionNo": "0000320193-25-000079",
  "primaryDoc": "aapl-20250927.htm",
  "fileUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"
}
```

### Rate limits and fair use

The SEC requires automated clients to identify themselves with a meaningful `User-Agent`, typically including an organization and email address. This Actor requires `userAgent` in input or `SEC_USER_AGENT` in the environment. Requests are throttled to at most 8 requests per second, below the SEC fair access ceiling of 10 requests per second. Keep `maxResults` reasonable, schedule monitors at practical intervals, and avoid running duplicate high-volume jobs against the same query.

The default input is intentionally small: it searches Form D filings from the last 7 days and returns up to 100 rows. That keeps Apify health checks fast and makes the Actor useful immediately after deployment.

### Suggested pricing

Recommended monetization is pay per event, where one event equals one normalized output result. Suggested public store tiers:

| Tier | Suggested price |
| --- | --- |
| Starter | $1.50 per 1,000 results |
| Growth | $1.90 per 1,000 results |
| Business | $2.30 per 1,000 results |
| Enterprise | $2.70 per 1,000 results |

This model aligns cost with delivered filings and works well for both small scheduled monitors and larger research exports.

### FAQ

**Do I need an SEC API key?**\
No. The Actor uses official public SEC endpoints that do not require an API key.

**Why is `userAgent` required?**\
SEC fair access rules require automated tools to identify themselves. Use a company name and contact email.

**Can I find startup funding leads?**\
Yes. Use `forms: ["D"]` or `["D", "D/A"]` with relevant search terms or run the default Form D search. Form D filings often indicate private offerings and fundraising activity.

**Can I monitor new filings automatically?**\
Yes. Use `monitor` mode on an Apify schedule. The Actor stores seen accession numbers and pushes only new matches.

**Can I search by ticker?**\
Ticker lookup is supported in `company` mode. Full-text `search` mode searches filing text and metadata, so use the company name, ticker text, or other query terms.

**Are results official SEC data?**\
Yes. Results come from official SEC EDGAR full-text search, company submissions, and archive URL conventions.

**Why do some search rows use `primary_doc.xml`?**\
Form D full-text search hits often point to XML primary documents. The Actor builds the direct archive URL from the accession number, CIK, and document name supplied by SEC.

# Actor input Schema

## `mode` (type: `string`):

Use search for EDGAR full-text search, company for one company submissions feed, or monitor to emit only newly seen search results.

## `query` (type: `string`):

Full-text search query. Use terms such as artificial intelligence, Series Seed, Form D, or issuer names.

## `forms` (type: `array`):

SEC form types to include. Common values: D, D/A, 10-K, 10-Q, 8-K, S-1.

## `startDate` (type: `string`):

Inclusive filing start date in YYYY-MM-DD format. If omitted, defaults to 7 days before the run date for search and monitor mode.

## `endDate` (type: `string`):

Inclusive filing end date in YYYY-MM-DD format. If omitted, defaults to the run date for search and monitor mode.

## `cik` (type: `string`):

Company CIK for company mode. Leading zeros are optional.

## `ticker` (type: `string`):

Ticker symbol for company mode. The Actor resolves it through the official SEC ticker mapping.

## `maxResults` (type: `integer`):

Maximum normalized rows to push to the dataset.

## `userAgent` (type: `string`):

Required by SEC fair access policy. Use a company name and email, for example: Acme Data contact@example.com.

## Actor input object example

```json
{
  "mode": "search",
  "query": "Form D",
  "forms": [
    "D"
  ],
  "maxResults": 100
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("vivid_astronaut/sec-edgar-filings-search").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("vivid_astronaut/sec-edgar-filings-search").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 vivid_astronaut/sec-edgar-filings-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=vivid_astronaut/sec-edgar-filings-search",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Sec Edgar Filings Search",
        "description": "Search SEC EDGAR filings in real time, monitor new disclosures, and extract normalized Form D startup funding leads from official public data. Full-text search, company filings by CIK or ticker, clean JSON output.",
        "version": "0.1",
        "x-build-id": "YPYsV7o8GccKaVDBb"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/vivid_astronaut~sec-edgar-filings-search/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-vivid_astronaut-sec-edgar-filings-search",
                "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/vivid_astronaut~sec-edgar-filings-search/runs": {
            "post": {
                "operationId": "runs-sync-vivid_astronaut-sec-edgar-filings-search",
                "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/vivid_astronaut~sec-edgar-filings-search/run-sync": {
            "post": {
                "operationId": "run-sync-vivid_astronaut-sec-edgar-filings-search",
                "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": [
                    "mode",
                    "maxResults"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "search",
                            "company",
                            "monitor"
                        ],
                        "type": "string",
                        "description": "Use search for EDGAR full-text search, company for one company submissions feed, or monitor to emit only newly seen search results.",
                        "default": "search"
                    },
                    "query": {
                        "title": "Search query",
                        "type": "string",
                        "description": "Full-text search query. Use terms such as artificial intelligence, Series Seed, Form D, or issuer names.",
                        "default": "Form D"
                    },
                    "forms": {
                        "title": "Forms",
                        "type": "array",
                        "description": "SEC form types to include. Common values: D, D/A, 10-K, 10-Q, 8-K, S-1.",
                        "items": {
                            "type": "string"
                        },
                        "default": [
                            "D"
                        ]
                    },
                    "startDate": {
                        "title": "Start date",
                        "type": "string",
                        "description": "Inclusive filing start date in YYYY-MM-DD format. If omitted, defaults to 7 days before the run date for search and monitor mode."
                    },
                    "endDate": {
                        "title": "End date",
                        "type": "string",
                        "description": "Inclusive filing end date in YYYY-MM-DD format. If omitted, defaults to the run date for search and monitor mode."
                    },
                    "cik": {
                        "title": "CIK",
                        "type": "string",
                        "description": "Company CIK for company mode. Leading zeros are optional."
                    },
                    "ticker": {
                        "title": "Ticker",
                        "type": "string",
                        "description": "Ticker symbol for company mode. The Actor resolves it through the official SEC ticker mapping."
                    },
                    "maxResults": {
                        "title": "Maximum results",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum normalized rows to push to the dataset.",
                        "default": 100
                    },
                    "userAgent": {
                        "title": "SEC User-Agent",
                        "type": "string",
                        "description": "Required by SEC fair access policy. Use a company name and email, for example: Acme Data contact@example.com."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```