Lo que devuelve
Datos oficiales de la SEC para cualquier empresa cotizada en EE.UU., como JSON limpio.
Usos comunes
Investigación de acciones, modelos financieros, monitoreo de competidores, fusión y adquisición y evaluación de riesgos, alertas de eventos 8-K. Pago por empresa o filing.
Solicitud
POST https://api.pushbuild.com/sec-edgar/run con un cuerpo en JSON. Envíe su clave en el encabezado X-API-Key.
| Campo | Tipo | Descripción |
|---|---|---|
companies | lista de cadenas | Tickers (AAPL, BRK.B) o números CIK. |
includeFilings | boolean | Filings recientes con enlaces a documentos. Valor predeterminado: true. |
forms | lista de cadenas | Solo estos formularios, p. ej. 10-K, 10-Q, 8-K, 4, S-1, DEF 14A. También filtra la búsqueda de texto completo. |
filedFrom | string | Solo filings desde esta fecha (YYYY-MM-DD) en adelante. |
filedUntil | string | Fecha final para la búsqueda de texto completo. |
maxFilingsPerCompany | entero | Más recientes primero. Valor predeterminado: 50. |
includeFinancials | boolean | Ingresos, beneficio bruto, ingresos operativos y netos, EPS, activos, pasivos, patrimonio, efectivo, deuda, flujo de efectivo, inversión en capital, I+D desde XBRL. Valor predeterminado: true. |
years | entero | Años fiscales a devolver. Valor predeterminado: 5. |
quarterly | boolean | También devolver valores Q1-Q3 desde 10-Qs. Valor predeterminado: false. |
fullTextQueries | lista de cadenas | Buscar el texto de todos los filings de EDGAR desde 2001, p. ej. "interrupción de la cadena de suministro". |
maxFullTextResults | entero | Documentos coincidentes a devolver. Valor predeterminado: 100. |
maxItems | entero | Número máximo de elementos a devolver (1-500). Predeterminado: 100. |
Ejemplo
curl -X POST https://api.pushbuild.com/sec-edgar/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"companies": ["AAPL", "NVDA"], "maxItems": 20}'
Respuesta
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}
Cada llamada devuelve hasta 500 elementos. Los registros que no pasan la validación o no se encuentran se marcan en los elementos y no se cobran.
Precios
Pague solo por los resultados devueltos: $0,40 por 1.000 filings · $2,40 por 1.000 empresas. Sin cargo por errores o búsquedas vacías.
Úselo desde Claude, ChatGPT o Cursor
Esta API también es un servidor MCP: https://api.pushbuild.com/mcp/sec-edgar. Agréguela a cualquier asistente que soporte servidores MCP remotos, con su clave en el encabezado X-API-Key. Mismos precios. Configuración para cada aplicación.
Díganos qué necesitan construir.
Preguntas sobre esta API, volúmenes más altos, o una fuente de datos que necesiten que aún no cubrimos.
hello@pushbuild.com