SEC EDGAR Entity Resolver

Resolve companies to SEC CIK numbers, search SEC filings, and extract structured XBRL financial facts from EDGAR. No API key required. MCP-ready for AI agent integration.

What does it do?

SEC EDGAR Entity Resolver turns company names, stock tickers, and CIK numbers into structured SEC data. It queries the SEC's public EDGAR APIs and returns clean, normalized results ready for analysis, compliance workflows, or AI agent consumption via MCP.

Use cases:

• Entity resolution -- ground company names to official SEC identifiers (CIK numbers) for downstream data pipelines
• Due diligence -- pull company profiles with SIC codes, addresses, fiscal year end, and filing history
• Compliance monitoring -- search SEC filings by form type, date range, and keyword to track regulatory submissions
• Financial analysis -- extract structured XBRL facts (revenue, assets, liabilities) from company filings
• AI agent tooling -- expose as an MCP tool so AI agents can look up SEC data in real time
• Investment research -- monitor 10-K, 10-Q, 8-K, and other filings for companies or industries

Features

• 3 modes: resolve_entity, search_filings, get_company_facts
• No API key required -- all data comes from public SEC EDGAR endpoints
• No proxies needed -- direct API access to government infrastructure
• Ticker preload -- loads SEC company_tickers.json for fast ticker-to-CIK resolution
• Polite rate limiting -- default 0.3s between requests; retry with exponential backoff on 429/5xx
• State persistence -- survives Apify actor migrations mid-run
• Batch push -- outputs in batches of 25 for efficiency
• Free tier -- 25 results per run without a subscription

What data does it extract?

Entities (resolve_entity)

Field	Description
schema_version	Schema version (currently "1.0")
type	Always "entity"
cik	10-digit SEC CIK number
name	Official company name
tickers	Stock ticker symbols
sic	SIC industry code
sic_description	SIC industry description
state	State of incorporation
country	Country of incorporation
fiscal_year_end	Fiscal year end (MMDD)
mailing_address	Mailing address
business_address	Business address
former_names	Previous company names
recent_filings	Recent SEC filings (form, date, accession number, URLs)
source_urls	SEC API URLs used

Filings (search_filings)

Field	Description
schema_version	Schema version (currently "1.0")
type	Always "filing"
cik	Filer CIK number
name	Filer name
tickers	Filer ticker symbols
form	Form type (10-K, 10-Q, 8-K, etc.)
file_date	Filing date
acceptance_datetime	SEC acceptance timestamp
accession_number	Unique filing accession number
filing_url	Link to filing index page
primary_document_url	Link to primary document
items	Filing items (for 8-K)
state	Filer state
sic	Filer SIC code
sic_description	Filer SIC description

Facts (get_company_facts)

Field	Description
schema_version	Schema version (currently "1.0")
type	Always "fact"
cik	Company CIK number
name	Company name
sic	SIC code
concept	XBRL concept name (e.g., Revenue, Assets)
namespace	XBRL namespace (e.g., us-gaap)
label	Human-readable concept label
unit	Unit of measurement (e.g., USD, shares)
value	Reported value
start	Period start date (duration facts)
end	Period end date
form	Source form type
frame	XBRL reporting frame (e.g., CY2025Q1)
filing_url	Link to source filing

---

👥 Who Uses This

📈 Financial Analysts & Investment Researchers

The most common workflow: pull annual reports for a company, compare performance across competitors, track how a metric has changed quarter over quarter. All three modes serve this directly.

• Resolve a company name or ticker to its CIK, then pull recent 10-K and 10-Q filings with direct URLs to the primary documents
• Search across an industry by keyword to find all companies disclosing a specific risk factor or business change
• Compare revenue, gross profit, and operating income across multiple companies using get_company_facts with specific XBRL concepts

{
    "mode": "search_filings",
    "query": "artificial intelligence revenue",
    "formTypes": ["10-K"],
    "dateFrom": "2024-01-01",
    "dateTo": "2026-01-01",
    "maxResults": 100,
    "userAgent": "YourName your-email@example.com"
}

📊 Quant Traders & Hedge Funds

XBRL financial facts are machine-readable, time-stamped, and directly comparable across companies. The get_company_facts mode returns structured time series — no PDF parsing required.

• Pull quarterly Revenue, Assets, and Liabilities time series for a company going back years
• Extract EPS, shares outstanding, or debt-to-equity ratios as structured data for modeling
• Cross-reference 8-K material event filings against price movement data for event-driven strategies

{
    "mode": "get_company_facts",
    "ticker": "NVDA",
    "namespaces": ["us-gaap"],
    "concepts": ["Revenues", "Assets", "LiabilitiesAndStockholdersEquity"],
    "maxResults": 500,
    "userAgent": "YourName your-email@example.com"
}

⚖️ Compliance & Legal Teams

Monitoring companies for material events, regulatory disclosures, and insider transactions requires catching 8-K and other filings as they land. This actor can be scheduled to run daily.

• Monitor a specific company for all 8-K material event filings — acquisitions, leadership changes, earnings, legal proceedings
• Search proxy statements (DEF 14A) and annual reports for specific disclosure language
• Track amendment filings (10-K/A, 8-K/A) to identify when companies are restating prior disclosures

{
    "mode": "search_filings",
    "ticker": "META",
    "formTypes": ["8-K", "8-K/A"],
    "dateFrom": "2025-01-01",
    "maxResults": 200,
    "userAgent": "YourName your-email@example.com"
}

🗞️ Investigative Journalists

Full-text keyword search across all SEC filings is one of EDGAR's most powerful but least accessible features. This actor exposes it as a simple JSON call.

• Search for a specific phrase across all public SEC filings to find which companies mentioned it
• Track disclosures around a breaking story — find every company that mentioned a specific risk, event, or name
• Pull a company's full filing history to trace a timeline of disclosures around a specific issue

{
    "mode": "search_filings",
    "query": "climate transition risk stranded assets",
    "formTypes": ["10-K"],
    "dateFrom": "2023-01-01",
    "maxResults": 200,
    "userAgent": "YourName your-email@example.com"
}

🤖 AI/LLM Engineers

SEC filings are dense, authoritative, and structured — ideal source material for financial AI agents and RAG pipelines. The entity resolution mode is especially useful as a first step in any company-focused pipeline.

• Resolve a company name to its CIK programmatically — necessary before any downstream EDGAR API calls
• Use via MCP so AI agents can look up company filings in real time from a natural language prompt
• Pull XBRL facts as structured financial context before generating analysis, summaries, or comparison reports

{
    "mode": "resolve_entity",
    "query": "OpenAI",
    "maxRecentFilings": 20,
    "userAgent": "YourName your-email@example.com"
}

---

🔗 Related Actors

Other actors from the same portfolio that pair well with SEC EDGAR data:

Actor	What It Does
Government Contracts Scraper	Federal contract awards from SAM.gov — research what government contracts awardees have won
Academic Paper Scraper	Research papers from ArXiv and Semantic Scholar — pair with EDGAR for tech company R&D analysis
Reddit Scraper	Retail investor sentiment from Reddit — cross-reference with SEC filings for market signal research
NPI Provider Contact Finder	Healthcare provider data — pairs with SEC filings research on pharma and healthcare companies

---

Input

Mode 1: Resolve Entity

Resolve a company name, ticker, or CIK to a full SEC entity profile with recent filings.

{
    "mode": "resolve_entity",
    "query": "NVIDIA",
    "maxRecentFilings": 10,
    "userAgent": "YourName your-email@example.com"
}

Resolve by ticker:

{
    "mode": "resolve_entity",
    "ticker": "AAPL",
    "maxRecentFilings": 5,
    "userAgent": "YourName your-email@example.com"
}

Mode 2: Search Filings

Search SEC filings by keyword, company, form type, and date range.

{
    "mode": "search_filings",
    "query": "artificial intelligence",
    "formTypes": ["10-K", "10-Q"],
    "dateFrom": "2025-01-01",
    "dateTo": "2026-01-01",
    "maxResults": 100,
    "userAgent": "YourName your-email@example.com"
}

Search by ticker and form prefix:

{
    "mode": "search_filings",
    "ticker": "TSLA",
    "formPrefix": "8-",
    "maxResults": 50,
    "userAgent": "YourName your-email@example.com"
}

Mode 3: Get Company Facts

Pull structured XBRL financial data for a company.

{
    "mode": "get_company_facts",
    "ticker": "MSFT",
    "namespaces": ["us-gaap"],
    "concepts": ["Revenue", "Assets"],
    "maxResults": 200,
    "userAgent": "YourName your-email@example.com"
}

Input Reference

Common fields:

Parameter	Default	Description
mode	resolve_entity	resolve_entity, search_filings, or get_company_facts
query		Company name, ticker, CIK, or search text
cik		10-digit CIK (zero-padded if shorter)
ticker		Stock ticker symbol
userAgent		SEC-required User-Agent: "YourName email@example.com"
maxResults	100	Max results (1-1000; free tier capped at 25)
requestIntervalSecs	0.3	Seconds between requests
timeoutSecs	30	HTTP timeout
maxRetries	5	Retries on failure

resolve_entity fields:

Parameter	Default	Description
maxRecentFilings	10	Recent filings to include (1-100)
includeAmendments	true	Include amended forms (*/A)
formPrefix		Filter filings by prefix (e.g., 10-)

search_filings fields:

Parameter	Default	Description
formTypes		List of forms: 10-K, 10-Q, 8-K, etc.
formPrefix		Prefix filter (e.g., 10- matches 10-K, 10-Q)
includeAmendments	true	Include amended forms (*/A)
dateFrom		Filed on or after (YYYY-MM-DD)
dateTo		Filed on or before (YYYY-MM-DD)
start	0	Pagination offset

get_company_facts fields:

Parameter	Default	Description
namespaces		XBRL namespaces (e.g., us-gaap, dei)
concepts		Concept names (e.g., Revenue, Assets)
periodType		instant or duration

---

Output

Results are saved to the default dataset. Download them in JSON, CSV, Excel, or XML from the Output tab.

Example: Entity output

{
    "schema_version": "1.0",
    "type": "entity",
    "cik": "0001045810",
    "name": "NVIDIA CORP",
    "tickers": ["NVDA"],
    "sic": "3674",
    "sic_description": "Semiconductors & Related Devices",
    "state": "DE",
    "country": "US",
    "fiscal_year_end": "0128",
    "mailing_address": {"street1": "2788 SAN TOMAS EXPRESSWAY", "city": "SANTA CLARA", "state": "CA", "zip": "95051"},
    "business_address": {"street1": "2788 SAN TOMAS EXPRESSWAY", "city": "SANTA CLARA", "state": "CA", "zip": "95051"},
    "former_names": [],
    "recent_filings": [
        {
            "form": "10-K",
            "fileDate": "2026-02-01",
            "accessionNumber": "0001045810-26-000123",
            "filingUrl": "https://www.sec.gov/Archives/edgar/data/...",
            "primaryDocumentUrl": "https://www.sec.gov/Archives/edgar/data/..."
        }
    ],
    "source_urls": ["https://data.sec.gov/submissions/CIK0001045810.json"]
}

Example: Filing output

{
    "schema_version": "1.0",
    "type": "filing",
    "cik": "0001318605",
    "name": "TESLA INC",
    "tickers": ["TSLA"],
    "form": "8-K",
    "file_date": "2026-01-15",
    "acceptance_datetime": "2026-01-15T16:30:00.000Z",
    "accession_number": "0001318605-26-000456",
    "filing_url": "https://www.sec.gov/Archives/edgar/data/...",
    "primary_document_url": "https://www.sec.gov/Archives/edgar/data/...",
    "items": ["2.02", "9.01"],
    "state": "TX",
    "sic": "3711",
    "sic_description": "Motor Vehicles & Passenger Car Bodies"
}

Example: Fact output

{
    "schema_version": "1.0",
    "type": "fact",
    "cik": "0000789019",
    "name": "MICROSOFT CORP",
    "sic": "7372",
    "concept": "Revenue",
    "namespace": "us-gaap",
    "label": "Revenue from Contract with Customer, Excluding Assessed Tax",
    "unit": "USD",
    "value": 56189000000,
    "start": "2025-07-01",
    "end": "2025-09-30",
    "form": "10-Q",
    "frame": "CY2025Q3",
    "filing_url": "https://www.sec.gov/Archives/edgar/data/..."
}

---

Cost

This actor uses pay-per-event (PPE) pricing. You pay only for the results you get.

• $0.50 per 1,000 results ($0.0005 per result)
• No proxy costs -- public government APIs
• No API key costs -- SEC EDGAR is free and public
• Free tier: 25 results per run (no subscription required)

---

Technical details

• SEC EDGAR EFTS API (efts.sec.gov/LATEST/search-index) for full-text filing search
• SEC EDGAR Submissions API (data.sec.gov/submissions/) for entity profiles and recent filings
• SEC EDGAR XBRL CompanyFacts API (data.sec.gov/api/xbrl/companyfacts/) for structured financial data
• SEC company tickers file (sec.gov/files/company_tickers.json) preloaded for fast ticker resolution
• SEC requires a User-Agent header with name and email on all requests
• Rate limited to 1 request per 0.3 seconds (configurable)
• Automatic retry with exponential backoff and jitter on failures
• Results pushed in batches of 25 for efficiency
• Actor state persisted across migrations
• No proxies, no browser, no cookies -- direct API access

---

MCP Integration

This actor works as an MCP tool through Apify's hosted MCP server. No custom server needed.

• Endpoint: https://mcp.apify.com?tools=labrat011/sec-edgar-scraper
• Auth: Authorization: Bearer <APIFY_TOKEN>
• Transport: Streamable HTTP
• Works with: Claude Desktop, Cursor, VS Code, Windsurf, Warp, Gemini CLI

Example MCP config (Claude Desktop / Cursor):

{
    "mcpServers": {
        "sec-edgar-scraper": {
            "url": "https://mcp.apify.com?tools=labrat011/sec-edgar-scraper",
            "headers": {
                "Authorization": "Bearer <APIFY_TOKEN>"
            }
        }
    }
}

AI agents can use this actor to resolve company names to CIK numbers, search SEC filings, and pull structured XBRL financial data -- all as a callable MCP tool.

---

FAQ

Do I need an API key?

No. SEC EDGAR is a public government data source with no authentication. You do need to provide a User-Agent header (name and email) per SEC's fair access policy.

What is a CIK?

A Central Index Key (CIK) is the SEC's unique identifier for every entity that files with the commission. Think of it as an SEC serial number for companies.

Can I combine filters?

Yes. For filing search, combine keyword + form types + date range + ticker/CIK. All filters are AND-combined.

What XBRL namespaces are available?

The most common are us-gaap (US financial reporting standards) and dei (document and entity information). Some companies also report under ifrs-full (international standards).

---

Feedback

Found a bug or have a feature request? Open an issue on the actor's Issues tab in Apify Console.