{
  "openapi": "3.0.1",
  "info": {
    "title": "SEC EDGAR Company Filing Trigger Monitor",
    "description": "Track public SEC company filings and detect business events from newly published reports. Extract company names, CIKs, tickers, filing types, filing dates, accession numbers, filing URLs, and trigger signals for analysts, enterprise sellers, compliance teams, and market research workflows.",
    "version": "0.0",
    "x-build-id": "h8yjppXjrgPTNWS65"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lead.gen.labs~sec-edgar-company-filing-trigger-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lead.gen.labs-sec-edgar-company-filing-trigger-monitor",
        "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/lead.gen.labs~sec-edgar-company-filing-trigger-monitor/runs": {
      "post": {
        "operationId": "runs-sync-lead.gen.labs-sec-edgar-company-filing-trigger-monitor",
        "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/lead.gen.labs~sec-edgar-company-filing-trigger-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-lead.gen.labs-sec-edgar-company-filing-trigger-monitor",
        "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": [
          "max_filings_per_company"
        ],
        "properties": {
          "tickers": {
            "title": "Stock Tickers",
            "type": "array",
            "description": "Public company ticker symbols to monitor. The Actor resolves these to SEC CIKs using SEC company_tickers.json.",
            "items": {
              "type": "string"
            },
            "default": [
              "AAPL"
            ]
          },
          "ciks": {
            "title": "CIKs",
            "type": "array",
            "description": "Optional SEC CIKs to monitor. CIKs can be provided with or without leading zeroes.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "forms": {
            "title": "Filing Forms",
            "type": "array",
            "description": "SEC form types to monitor, such as 8-K, 10-K, 10-Q, S-1, D, 3, 4, or SC 13D.",
            "items": {
              "type": "string"
            },
            "default": [
              "8-K",
              "10-K",
              "10-Q",
              "S-1",
              "D",
              "4"
            ]
          },
          "days_back": {
            "title": "Days Back",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Number of recent calendar days to monitor when start_date is not provided.",
            "default": 30
          },
          "start_date": {
            "title": "Start Date",
            "type": "string",
            "description": "Optional first filing date in YYYY-MM-DD format.",
            "default": ""
          },
          "end_date": {
            "title": "End Date",
            "type": "string",
            "description": "Optional last filing date in YYYY-MM-DD format. Defaults to today.",
            "default": ""
          },
          "trigger_keywords": {
            "title": "Trigger Keywords",
            "type": "array",
            "description": "Optional keywords that must appear in the company name, form, filing description, or filing items.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "items": {
            "title": "8-K Item Filters",
            "type": "array",
            "description": "Optional item filters such as 1.01, 2.02, 5.02, 7.01, or 9.01.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "max_filings_per_company": {
            "title": "Maximum Filings per Company",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum matching filing trigger records to save for each monitored company.",
            "default": 50
          },
          "fetch_filing_documents": {
            "title": "Fetch Filing Documents",
            "type": "boolean",
            "description": "Fetch primary filing documents for optional email extraction, text snippets, Form D people, and ownership reporting people.",
            "default": false
          },
          "include_filing_text_snippet": {
            "title": "Include Filing Text Snippet",
            "type": "boolean",
            "description": "Include a short text snippet from fetched filing documents. Requires fetch_filing_documents.",
            "default": false
          },
          "extract_emails": {
            "title": "Extract Public Emails",
            "type": "boolean",
            "description": "Extract distinct public email addresses if they appear in fetched public SEC filing documents.",
            "default": true
          },
          "request_delay_millis": {
            "title": "Request Delay",
            "minimum": 0,
            "maximum": 60000,
            "type": "integer",
            "description": "Delay between SEC requests in milliseconds. SEC asks automated clients to identify themselves and avoid excessive request rates.",
            "default": 250
          },
          "sec_user_agent": {
            "title": "SEC User Agent",
            "type": "string",
            "description": "Descriptive User-Agent with contact information for SEC fair access compliance.",
            "default": "leadgenlabs.sec.actor/1.0 lead.gen.labs.1@gmail.com"
          },
          "browser_impersonation": {
            "title": "Browser Impersonation",
            "type": "string",
            "description": "curl_cffi browser impersonation profile used for public SEC web requests.",
            "default": "chrome136"
          },
          "custom_proxy_url": {
            "title": "Custom Proxy URL",
            "type": "string",
            "description": "Optional proxy URL.",
            "default": ""
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}