получить данные
ru
~/public-data/sec-edgar-scraper

SEC EDGAR Scraper — отчетность, полнотекстовый поиск и финансовые данные XBRL

Извлекайте метаданные отчетности SEC EDGAR, полнотекстовые секции 10-K/10-Q, результаты полнотекстового поиска EDGAR и финансовые факты XBRL в виде чистого JSON, готового к RAG. API-ключ не требуется.

финансы TypeScriptCheerio США
запустить на Apify
proooxy/sec-edgar-scraper — характеристики
категорияpublic-data / финансы
языкTypeScript
стекTypeScript, Cheerio
рынкиСША
выводчистый JSON, готовый к RAG

ключевые возможности

Четыре режима в одном акторе — метаданные отчетности, полный текст документа, полнотекстовый поиск EDGAR и финансовые факты XBRL

Чанкинг, готовый к RAG, — section, paragraph (~2000 символов) или none; каждый чанк помечен исходным Item и порядковым номером

Автоматический парсинг секций «Item N» для 10-K/10-Q (Item 1A Risk Factors, Item 7 MD&A и другие)

Факты XBRL с таксономией, тегом, меткой, единицей измерения, значением, финансовым годом/периодом, формой и номером accession

Дедупликация фактов сворачивает переформулировки XBRL в одну строку на период, сохраняя самое раннее раскрытие

Определение компании по тикеру, CIK или названию по официальному файлу тикеров SEC, с нечетким поиском как запасным вариантом

Полнотекстовый поиск EDGAR с фразами в кавычках, фильтрами по типу формы и диапазону дат (2001 → настоящее время)

Ограничение частоты запросов и User-Agent в соответствии с требованиями SEC — без API-ключа и без входа

сценарии использования

  • RAG/LLM-конвейеры для финансов, которым нужен текст 10-K и 10-Q, разбитый на секции и готовый для эмбеддингов
  • Инвестиционные исследования — выгрузка временных рядов выручки, чистой прибыли и разводненной EPS в виде чистых строк XBRL
  • Мониторинг комплаенса и владения — Form 4, SC 13D/13G и формулировки риск-факторов по компаниям
  • Финтех-продукты, которым нужны структурированные данные EDGAR без разработки собственного краулера
  • Исследования рынка и отрасли через полнотекстовый поиск — кто и с каких пор раскрывает определенную формулировку
  • BI-процессы и работа с таблицами на основе чистых строк финансовых фактов XBRL

входные параметры

ПараметрТипОбязательныйОписание
modestringобязательноРежим извлечения: filings, fulltext, search или facts (по умолчанию: filings).
tickerstringопциональноБиржевой тикер, например AAPL. Во время выполнения обязателен один из параметров ticker/cik/companyName.
cikstringопциональноCentral Index Key SEC, например 320193 — имеет приоритет над ticker и companyName.
companyNamestringопциональноНазвание регистранта SEC, точное или нечеткое совпадение по официальному файлу тикеров.
querystringопциональноВыражение полнотекстового поиска EDGAR, например "supply chain disruption" — обязательно для режима search.
formTypesarrayопциональноТипы форм для включения, например 10-K, 10-Q, 8-K, S-1, DEF 14A, Form 4. Пусто = все формы.
chunkingstringопциональноСтратегия чанкинга для RAG: section, paragraph (~2000 символов) или none (по умолчанию: section).
maxItemsnumberопциональноМаксимум сохраняемых элементов; каждый сохраненный элемент — одно тарифицируемое событие (по умолчанию: 100).

Пример вывода

 1{
 2  "itemType": "filing-fulltext",
 3  "title": "Apple Inc. — 10-K 2025-10-31",
 4  "company": "Apple Inc.",
 5  "ticker": "AAPL",
 6  "cik": "0000320193",
 7  "formType": "10-K",
 8  "filedAt": "2025-10-31",
 9  "accessionNo": "0000320193-25-000123",
10  "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/...",
11  "sections": [
12    { "name": "Item 1A — Risk Factors", "charCount": 38241 },
13    { "name": "Item 7 — Management's Discussion and Analysis", "charCount": 21077 }
14  ],
15  "chunks": [
16    { "text": "The Company's business, reputation, results of operations...", "section": "Item 1A — Risk Factors", "order": 12 }
17  ],
18  "textLength": 220151
19}

Цена

Оплата за событие — вы платите только за фактически сохраненные элементы:

СобытиеЦенаЧто включено
Метаданные отчетности / результат поиска$0.001Одна запись метаданных отчетности или результат полнотекстового поиска
Отчетность с полным текстом$0.005Один отчет, извлеченный, разобранный на секции и разбитый на чанки для RAG
Факт XBRL$0.0002Одна строка финансового факта XBRL

Выгрузка метаданных 1000 отчетов — это ~$1.00; 1000 фактов XBRL — ~$0.20. maxItems ограничивает и объем, и стоимость.

Советы

  • Начните с режима facts для финансовых показателей. Выгрузка строк XBRL (выручка, чистая прибыль, EPS) намного дешевле и чище, чем разбор полных отчетов, если нужны только цифры.
  • Используйте chunking: section для RAG. Это сохраняет каждый Item (Risk Factors, MD&A) целостным, поэтому retrieval возвращает связные, пригодные для цитирования фрагменты.
  • Полнотекстовый поиск охватывает период с 2001 года. Для более старых раскрытий определите компанию по CIK и выгрузите метаданные отчетности напрямую.

частые вопросы

Нужен ли мне API-ключ SEC?
Нет. SEC EDGAR — это бесплатные открытые данные. Актор идентифицирует себя соответствующим требованиям User-Agent и автоматически ограничивает частоту запросов в рамках лимита SEC — без ключа и без входа.
На сколько лет назад доступны данные?
Полнотекстовый поиск EDGAR (EFTS) охватывает отчетность начиная с 2001-05-04 и ограничен 10 000 результатов на запрос. Метаданные отчетности доступны с 1994 года, а финансовые факты XBRL охватывают все, что компания раскрыла в формате XBRL.
Готов ли вывод для LLM и RAG?
Да. В режиме fulltext актор разбирает 10-K/10-Q на секции «Item N» и выдает чанки, готовые для эмбеддингов (section или абзацы по ~2000 символов), каждый из которых помечен исходным Item и порядковым индексом.
Почему некоторые отчеты пропускаются в режиме fulltext?
Отчеты, у которых основной документ не в формате HTML или TXT (например, XML Form 4 только в XBRL), нельзя разобрать на секции, поэтому они пропускаются — и не тарифицируются.

похожие в ~/public-data

Запустите SEC EDGAR Scraper — отчетность, полнотекстовый поиск и финансовые данные XBRL или закажите разработку под задачу

Начните извлекать данные на Apify за считаные минуты или закажите у меня разработку парсера на заказ и RAG-конвейера под ваш источник и схему.

запустить на Apify заказать данные