{
  "openapi": "3.0.1",
  "info": {
    "title": "SEC Form 4 Insider Trading & 13F Holdings Scraper",
    "description": "Track SEC Form 4 insider trading (buys, sells, options) and 13F hedge fund holdings with quarterly changes. Official EDGAR data, no API key.",
    "version": "0.1",
    "x-build-id": "MuI5XfOZ2lVtcfyVd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/deanko~sec-insider-13f-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-deanko-sec-insider-13f-scraper",
        "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/deanko~sec-insider-13f-scraper/runs": {
      "post": {
        "operationId": "runs-sync-deanko-sec-insider-13f-scraper",
        "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/deanko~sec-insider-13f-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-deanko-sec-insider-13f-scraper",
        "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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "insider",
              "13f"
            ],
            "type": "string",
            "description": "Insider trades: parse SEC Form 4 (optionally 3/5) filings into one row per transaction. Fund holdings: parse a fund's 13F-HR information table into one row per position, with quarter-over-quarter changes.",
            "default": "insider"
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stop after this many rows in total (trades or holdings). Each row is one billed result ($0.002), so 20 rows cost about $0.04. Raise it for bigger exports.",
            "default": 20
          },
          "tickers": {
            "title": "Tickers or CIKs (insider mode)",
            "type": "array",
            "description": "Company tickers (e.g. AAPL, NVDA, BRK.B) to get insider trades in that company's stock, or CIK numbers of a company or of an individual insider. Leave empty for the latest Form 4 filings across all US companies (newest first).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "dateFrom": {
            "title": "Filed from (YYYY-MM-DD)",
            "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string",
            "description": "Only filings filed on or after this date, e.g. 2026-10-01. Leave empty for newest filings first with no lower limit. Across all companies (no tickers), an empty start with an end date means 30 days before the end date.",
            "default": ""
          },
          "dateTo": {
            "title": "Filed to (YYYY-MM-DD)",
            "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string",
            "description": "Only filings filed on or before this date, e.g. 2026-10-15. Leave empty for today.",
            "default": ""
          },
          "formTypes": {
            "title": "Form types",
            "type": "array",
            "description": "Ownership forms to include: 4 and 4/A (changes in ownership), 5/5/A (annual), 3/3/A (initial holdings, returned as holding rows without a transaction).",
            "default": [
              "4",
              "4/A"
            ],
            "items": {
              "type": "string"
            }
          },
          "transactionCodes": {
            "title": "Transaction codes",
            "type": "array",
            "description": "Keep only these SEC transaction codes: P (open market buy), S (open market sale), A (grant/award), M (option exercise), F (tax withholding), G (gift), D (disposition to issuer). Leave empty for all codes.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "onlyOpenMarket": {
            "title": "Only open-market buys and sells (P/S)",
            "type": "boolean",
            "description": "Keep only open-market purchases (P) and sales (S), the trades investors watch most. Overrides Transaction codes. Tip: across all companies, combine with Minimum trade value.",
            "default": false
          },
          "minValue": {
            "title": "Minimum trade value (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only transactions where shares x price is at least this many US dollars, e.g. 1000000. Rows without a price (awards, gifts) are dropped when this is above 0.",
            "default": 0
          },
          "funds": {
            "title": "Fund CIKs or names (13F mode)",
            "type": "array",
            "description": "13F filer CIK numbers (e.g. 1067983 Berkshire Hathaway, 1350694 Bridgewater Associates) or fund names to look up on EDGAR (e.g. Pershing Square). The best name match is used and logged.",
            "default": [
              "1067983"
            ],
            "items": {
              "type": "string"
            }
          },
          "quarter": {
            "title": "Quarter",
            "pattern": "^(\\d{4}-?[Qq][1-4]|\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string",
            "description": "13F report period, e.g. 2025Q4 or 2025-12-31. Leave empty for the latest 13F-HR the fund has filed.",
            "default": ""
          },
          "compareToPreviousQuarter": {
            "title": "Compare to previous quarter",
            "type": "boolean",
            "description": "Add change columns versus the fund's previous 13F-HR: status (new, added, reduced, unchanged, soldOut), share change and % change. Positions fully sold are added as soldOut rows.",
            "default": true
          },
          "contactEmail": {
            "title": "Contact email for SEC User-Agent",
            "type": "string",
            "description": "Optional. The SEC asks automated clients to identify themselves in the User-Agent header. Add your own contact email here if you run large jobs; a generic no-reply address is used if empty. It is only sent to sec.gov, never stored in the output.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}