{
  "openapi": "3.0.1",
  "info": {
    "title": "13D/13G Stake Watch: Activist & 5% Ownership",
    "description": "New activist 13D and passive 13G stake reports as flat rows: holder, company, ticker, shares, percent of class, voting power and 13D purpose. New-only mode.",
    "version": "0.1",
    "x-build-id": "wg1JfhAfs4bFPLrRF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/glaciological_huddle~stake-13d-13g-watch/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-glaciological_huddle-stake-13d-13g-watch",
        "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/glaciological_huddle~stake-13d-13g-watch/runs": {
      "post": {
        "operationId": "runs-sync-glaciological_huddle-stake-13d-13g-watch",
        "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/glaciological_huddle~stake-13d-13g-watch/run-sync": {
      "post": {
        "operationId": "run-sync-glaciological_huddle-stake-13d-13g-watch",
        "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",
        "properties": {
          "formTypes": {
            "title": "Form types",
            "type": "array",
            "description": "Which schedules to read. 13D = activist or control intent (with the purpose of the stake in Item 4); 13G = passive investors and institutions above 5%. /A = amendments (changes in the stake). Default: 13D and 13D/A. Clear the list to read all four.",
            "items": {
              "type": "string",
              "enum": [
                "SCHEDULE 13D",
                "SCHEDULE 13D/A",
                "SCHEDULE 13G",
                "SCHEDULE 13G/A"
              ],
              "enumTitles": [
                "13D: new activist / control stake",
                "13D/A: amended activist stake",
                "13G: new passive 5%+ stake",
                "13G/A: amended passive stake"
              ]
            },
            "default": [
              "SCHEDULE 13D",
              "SCHEDULE 13D/A"
            ]
          },
          "tickers": {
            "title": "Tickers (subject companies)",
            "type": "array",
            "description": "Stock symbols of the companies whose holders you want to watch, e.g. AAPL, MSFT. Mapped to the company's CIK with the SEC's public company ticker file and used to pick filings from the daily index BEFORE anything is downloaded. Leave empty (and Issuer CIKs empty) for the whole market.",
            "items": {
              "type": "string"
            }
          },
          "issuerCiks": {
            "title": "Issuer CIKs",
            "type": "array",
            "description": "Optional Central Index Keys of subject companies (e.g. 320193 for Apple), for companies without a listed ticker. Combined with Tickers (either matches).",
            "items": {
              "type": "string"
            }
          },
          "filerNameContains": {
            "title": "Filer name contains",
            "type": "array",
            "description": "Keep only filings by investors whose name contains any of these words (case-insensitive), e.g. Elliott, Starboard, Icahn, Trian, Vanguard. Checked on the daily index BEFORE download and again on the reporting persons after parsing; a joint filing is kept whole (fund, manager and principal) when any of its reporting persons matches.",
            "items": {
              "type": "string"
            }
          },
          "minPercentOfClass": {
            "title": "Minimum percent of class",
            "minimum": 0,
            "maximum": 100,
            "type": "number",
            "description": "Keep only reporting persons who report at least this percentage of the class (e.g. 10). Rows without a percentage are left out when this is set. Leave empty for no minimum."
          },
          "daysBack": {
            "title": "Business days back",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many past business days of daily filing index files to read, plus today's if it has already been published (each day's index appears in the evening, US Eastern time). 1 is right for a daily schedule.",
            "default": 1
          },
          "onlyNew": {
            "title": "Only new since last run",
            "type": "boolean",
            "description": "Remember every row this watch has output (by filing and reporting person) and output only rows not seen before. Quiet runs output nothing and cost only the start fee. Turn off to re-output everything in the window.",
            "default": true
          },
          "watchName": {
            "title": "Watch name",
            "type": "string",
            "description": "Name of the saved watch. Each watch keeps its own memory (named key-value store stake-watch-<name>), so several watches ('activists', 'my-portfolio-holders') can run side by side. The memory also gives previousPercentOfClass when the same holder files again on the same company.",
            "default": "default"
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Hard cap on output rows per run. The run also stops early if your Apify spending limit for this run would be exceeded. Rows beyond the cap are left for the next run.",
            "default": 200
          },
          "maxFilingsScanned": {
            "title": "Max filings downloaded",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Hard cap on filings downloaded per run. A business day has a few dozen 13D/13D-A filings but several hundred 13G/13G-A filings (more in February, when annual 13G amendments are due); this cap keeps whole-market runs short. Filings beyond the cap are left for the next run.",
            "default": 300
          },
          "userAgentContact": {
            "title": "Contact for the User-Agent header (optional)",
            "type": "string",
            "description": "www.sec.gov asks automated tools to identify themselves with contact details. If you enter your e-mail address, requests are sent as 'StakeWatch/0.1 <your e-mail>'; otherwise the Actor's default identification is used. Sent only in the User-Agent header of requests to www.sec.gov; masked (e.g. j***@e***.com) in logs and the run summary."
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}