{
  "name": "sec-enforcement-litigation-delta-feed",
  "description": "Structures SEC.gov's own Litigation Releases and Administrative Proceedings feeds into delta events: respondent, statute/rule citations, monetary sanctions, and a best-effort linked EDGAR CIK. Outside the saturated 10-K/8-K/Form-4 filings-scraper niche. Pay-per-event: billed only for what changed.",
  "input_schema": {
    "type": "object",
    "properties": {
      "sources": {
        "type": "array",
        "description": "Which of SEC.gov's own enforcement feeds to walk each run. 'Litigation Releases' are HTML pages under sec.gov/enforcement-litigation/litigation-releases/lr-NNNNN (RSS at .../litigation-releases/rss, live-verified). 'Administrative Proceedings' link directly to PDF orders under sec.gov/files/litigation/admin/YYYY/34-NNNNNN.pdf (RSS at .../administrative-proceedings/rss, live-verified) and require a separate PDF text-extraction pass.",
        "default": [
          "litigation_releases",
          "administrative_proceedings"
        ],
        "items": {
          "type": "string",
          "enum": [
            "litigation_releases",
            "administrative_proceedings"
          ]
        }
      },
      "onlyNew": {
        "type": "boolean",
        "description": "When true (default), only NEW_LISTING and content-changed (UPDATED) records are pushed as charged events. Set false to also push free, uncharged SNAPSHOT_NO_DIFF records for every release the walk touches.",
        "default": true
      },
      "maxItemsPerRun": {
        "type": "integer",
        "description": "Caps the number of charged (result/result-summary) events this run will push, independent of your Apify spending limit. 0 means no Actor-side cap.",
        "default": 0,
        "minimum": 0
      },
      "enableCikLinking": {
        "type": "boolean",
        "description": "When true (default), each parsed respondent name is looked up against SEC's own EDGAR company database (browse-edgar company search) to attach a linked_edgar_cik. A match scoring below cikMatchConfidenceThreshold is left null rather than guessed.",
        "default": true
      },
      "cikMatchConfidenceThreshold": {
        "type": "number",
        "description": "Minimum name-match confidence (0-1) required before linked_edgar_cik is populated. Default 0.80 is deliberately conservative - a real respondent, 'Invesco Alpha Inc.', shares a name substring with the real, unrelated NYSE-listed Invesco Ltd, and a lower threshold would risk wrongly attaching a real public company's CIK to an unrelated enforcement action in your vendor-risk feed.",
        "default": 0.8,
        "minimum": 0.5
      },
      "watchlistNames": {
        "type": "array",
        "description": "Entity or individual names (case-insensitive substring match against parsed respondents) you specifically want flagged. A match sets is_watchlist_match: true.",
        "default": []
      },
      "userAgent": {
        "type": "string",
        "description": "SEC's own fair-access policy (sec.gov/os/webmaster-faq#developers) requires automated requests to sec.gov/data.sec.gov to declare a descriptive User-Agent identifying the requester, typically '<Your Company Name> <your-contact-email>'. Sent verbatim on every request.",
        "default": "DeltaRegistrySECMonitor/1.0 (+https://apify.com/stefano_seggio/sec-enforcement-litigation-delta-feed)"
      },
      "requestDelayMs": {
        "type": "integer",
        "description": "A flat delay applied between every successful request to sec.gov/data.sec.gov, independent of retries - a deliberately conservative default since this Actor's endpoints were live-verified for shape and availability only, not load-tested against SEC's general fair-access ceiling.",
        "default": 750,
        "minimum": 100
      },
      "maxRetries": {
        "type": "integer",
        "description": "Retry attempts for a 429/5xx response or a network-level failure before a request is treated as failed for this run. Exponential backoff (1000ms * 2^attempt, jittered, capped at 15s).",
        "default": 4,
        "minimum": 0
      },
      "requestTimeoutSecs": {
        "type": "integer",
        "description": "AbortSignal timeout applied to every individual HTTP request (feed page, release page, PDF download, EDGAR lookup).",
        "default": 30,
        "minimum": 5
      },
      "deltaStateName": {
        "type": "string",
        "description": "Names the Key-Value Store this schedule's seen-release state is kept in. Run two schedules - e.g. one full-coverage, one watchlist-only - without them draining each other's baseline by giving each a distinct name here.",
        "default": "default"
      },
      "resetState": {
        "type": "boolean",
        "description": "When true, clears this schedule's stored seen-release state before walking, so the next run re-baselines from scratch. Use for testing or recovering a corrupted state store, not routine operation.",
        "default": false
      }
    },
    "required": [
      "userAgent"
    ]
  }
}