{
  "openapi": "3.0.1",
  "info": {
    "title": "SEC EDGAR Filings Scraper (8-K, Form D, 10-K)",
    "description": "Every SEC EDGAR filing by form type and date, straight from the SEC: 8-K item codes, Form D, 10-K, company, CIK, ticker, SIC, state and document links.",
    "version": "0.1",
    "x-build-id": "cI2T95lIqMTcdw9Hj"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/knotty_mistveil~sec-edgar-filings/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-knotty_mistveil-sec-edgar-filings",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/knotty_mistveil~sec-edgar-filings/runs": {
      "post": {
        "operationId": "runs-sync-knotty_mistveil-sec-edgar-filings",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/knotty_mistveil~sec-edgar-filings/run-sync": {
      "post": {
        "operationId": "run-sync-knotty_mistveil-sec-edgar-filings",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "userAgent"
        ],
        "properties": {
          "userAgent": {
            "title": "User-Agent (your name and contact email)",
            "minLength": 5,
            "maxLength": 200,
            "type": "string",
            "description": "REQUIRED by the SEC. Every automated caller must identify itself in the shape \"Company Name contact@example.com\"; EDGAR answers requests without one with HTTP 403. Put your own organisation or project name and a mailbox someone actually reads - the prefill uses a placeholder domain and only exists so the Try button works."
          },
          "formTypes": {
            "title": "Form types",
            "type": "array",
            "description": "EDGAR form types to collect. Amendments are included by default (asking for 8-K also returns 8-K/A). Empty = every form EDGAR disseminated in the window (2,644 filings on 4 September 2026, across 108 root form types); with no form type and no keyword the window is read from the SEC's daily dissemination index instead of full-text search, so those records carry only form type, company, CIK, filing date and the filing link unless you also switch Fetch company details on. Default: 8-K and Form D.",
            "items": {
              "type": "string",
              "enum": [
                "8-K",
                "10-K",
                "10-Q",
                "20-F",
                "6-K",
                "S-1",
                "S-3",
                "S-4",
                "424B4",
                "DEF 14A",
                "DEFA14A",
                "D",
                "3",
                "4",
                "5",
                "13F-HR",
                "SC 13D",
                "SC 13G",
                "425",
                "144",
                "FWP",
                "S-8",
                "SC TO-I",
                "N-CSR"
              ],
              "enumTitles": [
                "8-K - current report (material events)",
                "10-K - annual report",
                "10-Q - quarterly report",
                "20-F - foreign private issuer annual report",
                "6-K - foreign private issuer current report",
                "S-1 - IPO / securities registration",
                "S-3 - shelf registration",
                "S-4 - merger / exchange offer registration",
                "424B4 - final prospectus",
                "DEF 14A - definitive proxy statement",
                "DEFA14A - additional proxy material",
                "D - Reg D private placement (funding round)",
                "3 - initial insider ownership",
                "4 - insider transaction",
                "5 - annual insider statement",
                "13F-HR - institutional holdings report",
                "SC 13D - activist 5% stake",
                "SC 13G - passive 5% stake",
                "425 - merger communication",
                "144 - notice of proposed sale of restricted stock",
                "FWP - free writing prospectus",
                "S-8 - employee benefit plan registration",
                "SC TO-I - issuer tender offer",
                "N-CSR - fund shareholder report"
              ]
            },
            "default": [
              "8-K",
              "D"
            ]
          },
          "otherFormTypes": {
            "title": "Other form types",
            "type": "array",
            "description": "Any EDGAR form type not on the list above, spelled exactly as EDGAR spells it: 10-D, 1-A, ABS-15G, N-PX, 485BPOS, SD, 25-NSE, C, IRANNOTICE, 11-K, POS AM. Case does not matter. Added to whatever is selected above.",
            "items": {
              "type": "string"
            }
          },
          "includeAmendments": {
            "title": "Include amendments",
            "type": "boolean",
            "description": "Keep amended filings (8-K/A, 10-K/A, D/A, ...) alongside the originals. EDGAR's search groups a form and its amendments together, so turning this off filters them out after the fact rather than making the run cheaper in requests. Amendments are a large share of some forms: on 3 September 2026, 15 of 21 Schedule 13D filings and 75 of 224 Form D filings were amendments.",
            "default": true
          },
          "daysBack": {
            "title": "Days back",
            "minimum": 1,
            "maximum": 12000,
            "type": "integer",
            "description": "Look-back window in days on the filing date, ending today. Ignored when Date from / Date to are set. EDGAR disseminates on business days only and the current day's feed fills through the afternoon (US Eastern), so the default 3 covers a normal midweek run but a window that lands on a weekend or a federal holiday returns nothing and says so in the log. Raise it to 4 or more for a scheduled daily run, so the window always spans a filing day whichever day it starts on.",
            "default": 3
          },
          "dateFrom": {
            "title": "Date from",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Start of the filing-date window, YYYY-MM-DD (inclusive). Overrides Days back. Full-text search covers 2001-01-01 onwards; earlier dates are read from the daily dissemination index, which this Actor can read back to 1995-01-01."
          },
          "dateTo": {
            "title": "Date to",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "End of the filing-date window, YYYY-MM-DD (inclusive). Defaults to today; a date in the future is clamped to today."
          },
          "keywords": {
            "title": "Keywords (full-text search)",
            "type": "array",
            "description": "Search the full text of the filing and every exhibit attached to it. Each term is matched as an exact phrase and the terms are ORed: [\"material definitive agreement\", \"letter of intent\"] keeps filings containing either. A term that already contains a double quote is passed to EDGAR untouched, so its own operators still work (-\"excluded phrase\", trunc*). Empty = no keyword filter, which returns every filing of the selected forms.",
            "items": {
              "type": "string"
            }
          },
          "companies": {
            "title": "Company name contains",
            "type": "array",
            "description": "Keep only filings whose filer name contains one of these strings, case-insensitively (\"bancorp\", \"acquisition corp\"). Matched on the filing's own filer names, including co-registrants. Empty = all companies.",
            "items": {
              "type": "string"
            }
          },
          "sicCodes": {
            "title": "SIC codes",
            "type": "array",
            "description": "Standard Industrial Classification codes or prefixes: 2836 keeps biological products, 28 keeps all of chemicals and pharmaceuticals, 6798 REITs, 7372 software, 6189 asset-backed issuers. The Actor turns every code into a readable industry name in sicDescription. Empty = all industries. About 4% of filers carry no SIC code and are dropped when this filter is set. The SIC comes from EDGAR's full-text search index, so filtering on it needs at least one form type or keyword selected - or Fetch company details switched on, which reads the code from the company profile instead.",
            "items": {
              "type": "string"
            }
          },
          "states": {
            "title": "States",
            "type": "array",
            "description": "EDGAR two-character state or country codes (CA, NY, TX, DE, MA; X0 Canada, U0 Singapore, L2 UK). A filing is kept when the code matches EITHER the filer's state of incorporation OR the state of its business address. Empty = everywhere. Like the SIC filter, this reads a field from EDGAR's full-text search index, so it needs at least one form type or keyword selected - or Fetch company details switched on.",
            "items": {
              "type": "string"
            }
          },
          "includeCompanyDetails": {
            "title": "Fetch company details",
            "type": "boolean",
            "description": "Call the data.sec.gov submissions API once per company per day to add the business address, phone number, entity type, stock exchanges, the EDGAR acceptance timestamp, the filing's size and its XBRL flag, and to fill the tickers and SIC for filers the search index leaves blank. Costs one extra request per company, so a run of 500 filings by 500 different companies roughly doubles in length.",
            "default": false
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Stop after this many filings. You are charged per filing delivered, so this is also the cost cap. Days are read newest first, so a value below the window's volume drops the OLDEST filings in the window. Measured 8 September 2026: a business day holds about 165 8-K and 220 Form D filings, so the default 3-day window with the default forms is roughly 1,100 filings.",
            "default": 500
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}