{
  "openapi": "3.0.1",
  "info": {
    "title": "SEC Form D Funding Tracker — Change Tracking + Signal Score",
    "description": "Track newly funded US startups from SEC Form D filings: company, amount raised, industry, state, executives and filing link. Filter by date, state, industry and amount. Pay only per filing returned. Optional change tracking and an explainable 0–100 signal score.",
    "version": "0.0",
    "x-build-id": "nKgQ5CFauN6xHbWyW"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/goldenrod_serrano~sec-form-d-funding-signals/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-goldenrod_serrano-sec-form-d-funding-signals",
        "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/goldenrod_serrano~sec-form-d-funding-signals/runs": {
      "post": {
        "operationId": "runs-sync-goldenrod_serrano-sec-form-d-funding-signals",
        "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/goldenrod_serrano~sec-form-d-funding-signals/run-sync": {
      "post": {
        "operationId": "run-sync-goldenrod_serrano-sec-form-d-funding-signals",
        "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": {
          "sampleMode": {
            "title": "Free sample mode (not charged)",
            "type": "boolean",
            "description": "Turn on to get a free preview: 5 operating companies from the last 3 days. All filters below are ignored and nothing is charged. Leave off for a normal run (each pushed filing = one 'filing' event).",
            "default": false
          },
          "daysBack": {
            "title": "Days back",
            "minimum": 1,
            "maximum": 90,
            "type": "integer",
            "description": "Scan EDGAR filings from the last N calendar days (business days only are fetched). Ignored if Start date is set. Max 90.",
            "default": 7
          },
          "startDate": {
            "title": "Start date (optional)",
            "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string",
            "description": "First filing date to scan, YYYY-MM-DD. Leave empty to use Days back."
          },
          "endDate": {
            "title": "End date (optional)",
            "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string",
            "description": "Last filing date to scan, YYYY-MM-DD. Defaults to today."
          },
          "categories": {
            "title": "Issuer types",
            "type": "array",
            "description": "operating_company = real startups/companies (default). pooled_fund = VC/PE/hedge funds. spv_or_vehicle = SPVs, co-invest and holding vehicles. real_estate = REITs and property deals.",
            "items": {
              "type": "string",
              "enum": [
                "operating_company",
                "pooled_fund",
                "spv_or_vehicle",
                "real_estate"
              ],
              "enumTitles": [
                "Operating companies (startups)",
                "Pooled investment funds",
                "SPVs / investment vehicles",
                "Real estate"
              ]
            },
            "default": [
              "operating_company"
            ]
          },
          "industries": {
            "title": "Industries (optional)",
            "type": "array",
            "description": "Exact Form D industry group names, e.g. Biotechnology, Computers, Other Technology, Pharmaceuticals, Other Health Care, Business Services, Retailing, Manufacturing, Telecommunications, Other Energy, Oil and Gas. Empty = all.",
            "items": {
              "type": "string"
            }
          },
          "states": {
            "title": "Issuer states (optional)",
            "type": "array",
            "description": "Two-letter US state codes of the issuer's principal place of business, e.g. CA, NY, TX, MA. Empty = all (including non-US EDGAR codes).",
            "items": {
              "type": "string"
            }
          },
          "minAmountSold": {
            "title": "Minimum amount raised (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only filings whose total amount sold is at least this much. 0 = no minimum."
          },
          "maxAmountSold": {
            "title": "Maximum amount raised (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only filings whose total amount sold is at most this much. 0 = no maximum."
          },
          "onlyIncorporatedWithin5Years": {
            "title": "Only companies incorporated in the last 5 years",
            "type": "boolean",
            "description": "Keep only issuers that ticked 'within five years' on Form D — a good young-startup filter.",
            "default": false
          },
          "onlyNewOfferings": {
            "title": "Only new offerings (skip amendments)",
            "type": "boolean",
            "description": "Skip Form D/A amendments so each round appears once. Turn off to also see updated totals.",
            "default": true
          },
          "companyKeywords": {
            "title": "Company name must contain (optional)",
            "type": "array",
            "description": "Keep only issuers whose name contains any of these words (case-insensitive), e.g. AI, Bio, Robotics.",
            "items": {
              "type": "string"
            }
          },
          "excludeCompanyKeywords": {
            "title": "Exclude company names containing (optional)",
            "type": "array",
            "description": "Drop issuers whose name contains any of these words, e.g. Holdings, Capital.",
            "items": {
              "type": "string"
            }
          },
          "onlyNewSinceLastRun": {
            "title": "Monitor mode: only filings not seen in earlier runs",
            "type": "boolean",
            "description": "Remember accession numbers in a named key-value store so scheduled runs return only new filings (you are not charged twice for the same filing).",
            "default": false
          },
          "stateKey": {
            "title": "State key (for change tracking / monitor)",
            "type": "string",
            "description": "Name for the saved state. Use different keys for separate watch lists (e.g. 'tech-weekly', 'health-q4'). Required for change tracking and for the older monitor mode.",
            "default": "default"
          },
          "changeTracking": {
            "title": "Change tracking (new vs repeat issuers)",
            "type": "boolean",
            "description": "Off by default. Remembers every issuer (CIK) delivered under your Monitor state key. Later runs skip filings you already got and label each row change_type 'new' (issuer never seen before) or 'changed' (a new Form D or a D/A amendment from an issuer you already have, with previous_amount_sold_usd and amount_sold_delta_usd). Amendments from tracked issuers are included even when 'Only new offerings' is on. Max results and Max filings to scan only limit output: every candidate filing in the window is saved as seen, so capped-out filings are never sent or charged later (see skipped_by_max_results in RUN_SUMMARY). Only filings stopped by your max charge are carried over. When on, it replaces 'Only new since last run' for this run.",
            "default": false
          },
          "signalScoring": {
            "title": "Signal score (0–100 with reasons)",
            "type": "boolean",
            "description": "Off by default. Adds signal_score, signal_tier (hot/warm/cool/cold) and score_reasons to each filing: amount raised (35), first EDGAR filing / new offering (20), incorporated within 5 years (15), industry (15), first sale to filing freshness (10), round traction (5). Uses one extra SEC request per delivered filing (the issuer's EDGAR folder listing) to check whether this is its first filing.",
            "default": false
          },
          "scoreIndustries": {
            "title": "Target industries for the score (optional)",
            "type": "array",
            "description": "Exact Form D industry group names that get the full 15 industry points, e.g. Biotechnology, Other Technology. Empty = built-in weights (technology 15, health/biotech 12, energy 10, other operating 6, finance/real estate 0).",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Stop after this many matched filings. Each pushed filing is one charged 'filing' event. With change tracking on, every candidate in the date window is saved as seen: this cap only limits how many rows this run outputs. Filings cut by the cap are not sent or charged later (see skipped_by_max_results in RUN_SUMMARY). Raise it (or raise Max filings to scan) on the baseline run if those skip counts are not 0 and you want a fuller baseline.",
            "default": 200
          },
          "maxFilingsToScan": {
            "title": "Max filings to download",
            "minimum": 10,
            "maximum": 20000,
            "type": "integer",
            "description": "Safety cap on Form D XML documents fetched from EDGAR per run.",
            "default": 3000
          },
          "requestsPerSecond": {
            "title": "SEC request rate",
            "minimum": 1,
            "maximum": 9,
            "type": "integer",
            "description": "Requests per second to sec.gov. SEC fair-access policy allows at most 10; capped at 9, default 5.",
            "default": 5
          },
          "userAgent": {
            "title": "User-Agent contact (optional)",
            "type": "string",
            "description": "SEC asks automated tools to declare 'Company Name email@example.com'. Leave empty to use the Actor's default contact."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}