{
  "title": "SEC EDGAR - choose companies or a filing query",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "tickers": {
      "title": "Tickers (company mode)",
      "type": "array",
      "description": "Stock tickers to monitor, e.g. 'AAPL', 'MSFT', 'NVDA'. When set, the Actor pulls these companies' recent filings. Leave empty to use keyword search instead.",
      "editor": "stringList",
      "default": [],
      "prefill": [
        "AAPL"
      ],
      "sectionCaption": "1 · Company or filing search",
      "sectionDescription": "Use company identifiers or a filing keyword search as described below."
    },
    "ciks": {
      "title": "CIKs (company mode)",
      "type": "array",
      "description": "SEC CIK numbers to monitor (alternative to tickers), e.g. '0000320193'. Useful for funds/entities without a ticker.",
      "editor": "stringList",
      "default": [],
      "example": [
        "0000320193",
        "0001166559"
      ]
    },
    "keyword": {
      "title": "Keyword (search mode)",
      "type": "string",
      "description": "Full-text search term across ALL EDGAR filings, e.g. a competitor name, product, or risk phrase. Used only when no tickers/CIKs are provided. Wrap a phrase in quotes for exact match.",
      "editor": "textfield",
      "example": "\"artificial intelligence\""
    },
    "formTypes": {
      "title": "Form types",
      "type": "array",
      "description": "Filter to these SEC form types, e.g. '8-K', '10-K', '10-Q', '4' (insider), '13F-HR' (fund holdings), 'S-1'. Company mode matches the form string exactly, so '8-K' excludes '8-K/A'; keyword search mode treats '8-K' as a root form and includes its amendments. Leave empty for all forms.",
      "editor": "stringList",
      "default": [],
      "example": [
        "10-K",
        "8-K"
      ],
      "sectionCaption": "2 · Filing filters",
      "sectionDescription": "Narrow filing types and publication dates."
    },
    "startDate": {
      "title": "Filed since",
      "type": "string",
      "description": "Only include filings filed on or after this date, written as YYYY-MM-DD. This filters on the SEC filing date, not the report period, and EDGAR full-text search (keyword mode) only has meaningful coverage from 2001 onward.",
      "editor": "textfield",
      "example": "2026-06-01"
    },
    "endDate": {
      "title": "Filed until",
      "type": "string",
      "description": "Only include filings filed on or before this date, written as YYYY-MM-DD. Leave empty for no upper bound; a value that is not in YYYY-MM-DD form is silently ignored rather than erroring.",
      "editor": "textfield",
      "example": "2026-09-30"
    },
    "maxResults": {
      "title": "Maximum filing records",
      "type": "integer",
      "description": "Upper bound on the number of filings returned per run, counted across all tickers and CIKs combined rather than per company. Defaults to 1000; keyword search mode is additionally capped at EDGAR's own 10,000-result ceiling.",
      "editor": "number",
      "default": 1000,
      "minimum": 1,
      "sectionCaption": "3 · Run limits",
      "sectionDescription": "Bound the collection before expanding your scope."
    },
    "maxRunSeconds": {
      "title": "Run time budget (seconds)",
      "type": "integer",
      "description": "Wall-clock budget for this run, in seconds. When it is reached the Actor stops cleanly and finishes successfully with the rows it already collected, instead of being killed mid-run. Full-text search pages 100 filings at a time and EDGAR can stall; company mode is one request per company. Raise it (and the run timeout in Run options) for a deliberately large job.",
      "editor": "number",
      "default": 240,
      "minimum": 30
    },
    "contactEmail": {
      "title": "Contact email (optional)",
      "type": "string",
      "description": "Optional contact email included in the SEC-required User-Agent header. The SEC asks scrapers to identify themselves. Defaults to a generic address.",
      "editor": "textfield",
      "sectionCaption": "4 · SEC request identification",
      "sectionDescription": "Follow the SEC contact-identification requirement described in the field help."
    }
  },
  "description": "Choose company identifiers or a filing keyword search, then set filing types, dates and a small result cap. Results link to SEC filings; they are not financial analysis."
}