{
  "openapi": "3.0.1",
  "info": {
    "title": "SEC Form D New Private Raises Feed",
    "description": "Parses Form D filings from the SEC's official EDGAR daily index into a structured feed of new private offerings: issuer, state, industry, amount offered and sold, exemption and investor count. Related persons and other individual personal data are excluded by design.",
    "version": "0.1",
    "x-build-id": "bvnO7xXofbwFecvnc"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/opendatalabs~sec-form-d-feed/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-opendatalabs-sec-form-d-feed",
        "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/opendatalabs~sec-form-d-feed/runs": {
      "post": {
        "operationId": "runs-sync-opendatalabs-sec-form-d-feed",
        "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/opendatalabs~sec-form-d-feed/run-sync": {
      "post": {
        "operationId": "run-sync-opendatalabs-sec-form-d-feed",
        "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": {
          "contactEmail": {
            "title": "Your contact email (required by the SEC to fetch filings)",
            "type": "string",
            "description": "The SEC's EDGAR fair-access policy requires automated clients to identify themselves with a reachable contact address, which is sent in the User-Agent header on every request. This Actor has no email compiled into it. Use an address you actually monitor; the SEC blocks traffic that it cannot trace. If you leave this empty, the run makes no SEC requests, charges no filings, and returns one row explaining what to add."
          },
          "organizationName": {
            "title": "Your organisation name",
            "type": "string",
            "description": "Also sent in the User-Agent, in front of the Actor name, so the SEC can see which company the traffic belongs to."
          },
          "startDate": {
            "title": "Start date",
            "type": "string",
            "description": "First filing date to include, as YYYY-MM-DD. Defaults to seven days ago. EDGAR publishes an index only on business days; weekends and federal holidays are skipped automatically rather than reported as errors."
          },
          "endDate": {
            "title": "End date",
            "type": "string",
            "description": "Last filing date to include, as YYYY-MM-DD, inclusive. Defaults to today. Today's index appears after EDGAR's daily dissemination finishes, so an early-morning run may legitimately find nothing for today."
          },
          "includeAmendments": {
            "title": "Include amendments (Form D/A)",
            "type": "boolean",
            "description": "Amendments report updated totals for an offering already filed. Keep them to track how a raise fills up over time; turn them off for a clean feed of first-time filings only.",
            "default": true
          },
          "states": {
            "title": "Issuer state or country codes",
            "type": "array",
            "description": "Two-character EDGAR codes for the issuer's own state or country, for example CA, NY, TX or DE. Non-US issuers use codes such as X1. Leave empty for everywhere.",
            "items": {
              "type": "string"
            }
          },
          "industryGroups": {
            "title": "Industry groups",
            "type": "array",
            "description": "Case-insensitive substring match against the Form D industry group, for example Technology, Pooled Investment Fund, Real Estate, Health Care or Biotechnology. Leave empty for every industry.",
            "items": {
              "type": "string"
            }
          },
          "entityTypes": {
            "title": "Issuer entity types",
            "type": "array",
            "description": "Case-insensitive substring match on the issuer's entity type, for example Corporation, Limited Partnership or Limited Liability Company.",
            "items": {
              "type": "string"
            }
          },
          "exemptions": {
            "title": "Federal exemption codes",
            "type": "array",
            "description": "Form D item codes. 06b is Rule 506(b) (no general solicitation), 06c is Rule 506(c) (general solicitation allowed), 05 is Rule 504, and 3C.x are Investment Company Act section 3(c) exclusions used by funds.",
            "items": {
              "type": "string"
            }
          },
          "minOfferingAmount": {
            "title": "Minimum total offering amount (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Drops filings whose stated total offering is below this. Filings that declare an indefinite offering have no number to compare and are governed by the indefinite-offerings switch instead."
          },
          "maxOfferingAmount": {
            "title": "Maximum total offering amount (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Drops filings whose stated total offering is above this. Useful for screening out large institutional raises when you are looking for early-stage companies. Like the minimum, it is only applied to filings that state a number, so indefinite offerings are governed by the indefinite-offerings switch instead."
          },
          "minAmountSold": {
            "title": "Minimum amount already sold (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Useful for filtering out shell filings that have raised nothing yet."
          },
          "includeIndefiniteOfferings": {
            "title": "Include indefinite offerings",
            "type": "boolean",
            "description": "Pooled investment funds often file an 'Indefinite' total offering amount instead of a number. Keep them in unless you are strictly screening by raise size.",
            "default": true
          },
          "maxFilings": {
            "title": "Max filings per run",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Maximum number of Form D filings delivered (after your filters), newest days first. EDGAR sees roughly 100 to 350 Form D filings on a typical business day. With filters, up to 100 filings are scanned per filing requested (at least 500); scanned filings that your filters remove are free. The default of 10 caps a first run at about $0.40 ($0.04 per filing delivered); raise it (for example to 300) for a full business day.",
            "default": 10
          },
          "requestsPerSecond": {
            "title": "Requests per second",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Hard rate ceiling, enforced by a token bucket with no burst allowance. The SEC's published limit is 10 per second; the default of 7 leaves room for retries without crossing it. Raising this to 10 removes that margin.",
            "default": 7
          },
          "concurrency": {
            "title": "Concurrent filing downloads",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many filings are fetched in parallel. The requests-per-second ceiling still applies on top of this.",
            "default": 5
          },
          "outputFailedFilings": {
            "title": "Write a row for filings that could not be parsed",
            "type": "boolean",
            "description": "Emits a row with ok=false, the accession number and the reason, so a gap in the feed is visible rather than silent.",
            "default": true
          },
          "maxRetries": {
            "title": "Attempts per request",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Total attempts, including the first. Retries back off exponentially with jitter and honour Retry-After, which matters here because EDGAR throttles clients that exceed its fair-access limits. Only transient failures are retried; a missing filing is not.",
            "default": 4
          },
          "requestTimeoutSecs": {
            "title": "Request timeout (seconds)",
            "minimum": 5,
            "maximum": 300,
            "type": "integer",
            "description": "How long to wait for a single EDGAR request before giving up on that attempt. A daily index listing several thousand filings is the largest download in a typical run.",
            "default": 45
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}