# SEC 13D/G Ownership Changes – Evidence API (`bb-tradetec/sec-13dg-ownership-change-normalizer`) Actor Normalize official structured SEC Schedule 13D/G filings into issuer, reporting-person, security, ownership-change, and bounded purpose-evidence records with stateless cursors. - **URL**: https://apify.com/bb-tradetec/sec-13dg-ownership-change-normalizer.md - **Developed by:** [BB](https://apify.com/bb-tradetec) (community) - **Categories:** Developer tools, News, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $8.00 / 1,000 normalized ownership filings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## SEC 13D/G Ownership Changes – Evidence API Turn official structured SEC Schedule 13D, 13D/A, 13G, and 13G/A filings into deterministic beneficial-ownership records. Each dataset row represents one unique accession and keeps the subject issuer, security classes and CUSIPs, reporting persons, non-aggregated ownership statements, conservative amendment deltas, and direct SEC provenance together. The Actor uses public SEC EDGAR data only. It does not use an LLM, infer an activist or takeover intent, map CUSIPs through a third party, or parse legacy HTML into guessed ownership figures. ### Minimal input ```json { "queries": [ { "requestId": "issuer-ownership", "scope": "subject", "identifierType": "ticker", "identifier": "DIS" } ] } ```` Query scopes: - `subject`: exact SEC ticker, CIK, or company name; - `reportingPerson`: exact reporting-person CIK, never a fuzzy name; - `accessionNumber`: exact accession plus a separate `subjectCik`. The accession prefix is not treated as the subject issuer. The Actor returns at most 50 globally deduplicated filings. Repeated matches merge sorted `requestIds` into one row. ### Ownership and changes Numeric SEC values are serialized as canonical decimal strings. `"0"`, `null`, and a missing relationship remain distinct. Values across people or security classes are never added. CUSIPs remain official filing text and are not mapped to market symbols. For an amendment, `includeOwnershipChanges=true` permits one additional prior document download. Deltas are produced only for a unique match with the same Schedule family, overlapping reporting-person identity, and compatible CUSIP or class title. Otherwise `comparisonStatus` explains that no safe comparison was available. Schedule 13D Item 4 can be returned as bounded source evidence. `compact` mode removes its prose while retaining status, original character count, source anchor, and rule ID. The text is never converted into intent labels. ### Outputs and cost control - Default dataset: successful `beneficial_ownership_filing` rows only. - `SUMMARY`: counts, warnings, limits, and optional `nextCursor`. - `ERRORS`: bounded partial query/document errors. Exactly one reserved `apify-default-dataset-item` PPE event is attached to each dataset row. `maxEvents` is therefore the direct result-charge ceiling. Pricing in the product specification is planning only; this local Actor has not been deployed, published, or monetized. Confirm the live Apify Pricing tab after any future release. ### Incremental polling Set `incremental` to `{}` on the first run. Copy `SUMMARY.nextCursor` unchanged into the next run. The opaque cursor is query/filter scoped, carries bounded overlap IDs, and requires no publisher-side watchlist. A filing is atomic and is never split between runs. ### Network and data limits The Actor identifies itself to the SEC, stays at or below eight requests per second, uses 30-second timeouts and at most three attempts for 408/429/temporary 5xx responses, rejects redirects before following them, streams documents, caps one XML document at 5 MB and run filing data at 50 MB, and accepts only official HTTPS SEC hosts. Public SEC information is provided as filed and can contain filer errors or omissions. This Actor is not affiliated with the SEC and does not provide legal or investment advice. See the exact [interface](./docs/product/interface.md), [implementation contract](./docs/implementation-spec.md), and [test plan](./docs/test-plan.md). # Actor input Schema ## `queries` (type: `array`): Use a unique safe requestId. Subject supports ticker, CIK, or exact SEC company name; reportingPerson requires CIK; accessionNumber requires an exact accession plus subjectCik. ## `forms` (type: `array`): One to four unique canonical Schedule form filters. ## `filedFrom` (type: `string`): Inclusive YYYY-MM-DD filing-date lower bound; baseline lookup can inspect one earlier filing. ## `filedTo` (type: `string`): Inclusive YYYY-MM-DD filing-date upper bound; must not precede filedFrom. ## `includeOwnershipChanges` (type: `boolean`): For amendments, fetch at most one bounded prior filing and calculate only unambiguous statement deltas. ## `includePurposeEvidence` (type: `boolean`): Return bounded source prose only. No activist, takeover, merger, or intent classification is produced. ## `evidenceMaxChars` (type: `integer`): Hard bound for returned Schedule 13D Item 4 source text; original length and truncation stay explicit. ## `maxFilingsPerQuery` (type: `integer`): Hard bound on selected output filing candidates per exact query. ## `maxEvents` (type: `integer`): Hard dataset-row and pay-per-event result ceiling after global recordId deduplication. ## `outputSchemaVersion` (type: `string`): Published deterministic dataset contract; only version 1.0 is currently supported. ## `outputMode` (type: `string`): compact omits the bounded Item 4 prose but preserves status, counts, source, and rule metadata. ## `incremental` (type: `object`): First run: omit cursor. Later pass SUMMARY.nextCursor unchanged. Exact accession queries are not allowed in incremental mode. ## Actor input object example ```json { "queries": [ { "requestId": "issuer-ownership", "scope": "subject", "identifierType": "ticker", "identifier": "DIS" } ], "forms": [ "SC 13D", "SC 13D/A", "SC 13G", "SC 13G/A" ], "includeOwnershipChanges": true, "includePurposeEvidence": true, "evidenceMaxChars": 3000, "maxFilingsPerQuery": 25, "maxEvents": 50, "outputSchemaVersion": "1.0", "outputMode": "full" } ``` # Actor output Schema ## `events` (type: `string`): Default dataset. Each row is one unique structured Schedule filing and one beneficial-ownership-filing event. ## `summary` (type: `string`): Non-chargeable SUMMARY record with counts, limits, warnings, and optional nextCursor. ## `errors` (type: `string`): Non-chargeable ERRORS record. Valid batch results remain available when another query or filing fails. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("bb-tradetec/sec-13dg-ownership-change-normalizer").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("bb-tradetec/sec-13dg-ownership-change-normalizer").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call bb-tradetec/sec-13dg-ownership-change-normalizer --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bb-tradetec/sec-13dg-ownership-change-normalizer", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC 13D/G Ownership Changes – Evidence API", "description": "Normalize official structured SEC Schedule 13D/G filings into issuer, reporting-person, security, ownership-change, and bounded purpose-evidence records with stateless cursors.", "version": "0.1", "x-build-id": "SGUMHNNGCxnRObg4y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bb-tradetec~sec-13dg-ownership-change-normalizer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bb-tradetec-sec-13dg-ownership-change-normalizer", "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/bb-tradetec~sec-13dg-ownership-change-normalizer/runs": { "post": { "operationId": "runs-sync-bb-tradetec-sec-13dg-ownership-change-normalizer", "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/bb-tradetec~sec-13dg-ownership-change-normalizer/run-sync": { "post": { "operationId": "run-sync-bb-tradetec-sec-13dg-ownership-change-normalizer", "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": [ "queries" ], "properties": { "queries": { "title": "Subject, reporting-person, or accession queries", "minItems": 1, "maxItems": 20, "type": "array", "description": "Use a unique safe requestId. Subject supports ticker, CIK, or exact SEC company name; reportingPerson requires CIK; accessionNumber requires an exact accession plus subjectCik.", "items": { "type": "object", "additionalProperties": false, "required": [ "requestId", "scope", "identifierType", "identifier" ], "properties": { "requestId": { "title": "Request ID", "description": "Caller-defined stable correlation ID returned in matching rows; do not place secrets or personal free text here.", "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9._:-]+$" }, "scope": { "title": "Query scope", "description": "Search by subject issuer, exact reporting-person CIK, or exact accession plus subject CIK.", "type": "string", "enum": [ "subject", "reportingPerson", "accessionNumber" ] }, "identifierType": { "title": "Identifier type", "description": "The exact identifier vocabulary allowed by the selected scope.", "type": "string", "enum": [ "ticker", "cik", "companyName", "accessionNumber" ] }, "identifier": { "title": "Exact identifier", "description": "Exact ticker, CIK, SEC company name, or accession number; no comma-separated lists or fuzzy person names.", "type": "string", "minLength": 1, "maxLength": 200 }, "subjectCik": { "title": "Subject CIK for exact accession", "description": "Required only for accessionNumber scope. An accession prefix is never assumed to be the subject CIK.", "type": "string", "pattern": "^\\d{1,10}$" } } }, "default": [ { "requestId": "issuer-ownership", "scope": "subject", "identifierType": "ticker", "identifier": "DIS" } ] }, "forms": { "title": "Schedule forms", "minItems": 1, "maxItems": 4, "uniqueItems": true, "type": "array", "description": "One to four unique canonical Schedule form filters.", "items": { "type": "string", "pattern": "^SC 13[DG](?:/A)?$" }, "default": [ "SC 13D", "SC 13D/A", "SC 13G", "SC 13G/A" ] }, "filedFrom": { "title": "Filed from", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Inclusive YYYY-MM-DD filing-date lower bound; baseline lookup can inspect one earlier filing." }, "filedTo": { "title": "Filed to", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Inclusive YYYY-MM-DD filing-date upper bound; must not precede filedFrom." }, "includeOwnershipChanges": { "title": "Compare amendments", "type": "boolean", "description": "For amendments, fetch at most one bounded prior filing and calculate only unambiguous statement deltas.", "default": true }, "includePurposeEvidence": { "title": "Include Schedule 13D Item 4 evidence", "type": "boolean", "description": "Return bounded source prose only. No activist, takeover, merger, or intent classification is produced.", "default": true }, "evidenceMaxChars": { "title": "Maximum purpose-evidence characters", "minimum": 500, "maximum": 5000, "type": "integer", "description": "Hard bound for returned Schedule 13D Item 4 source text; original length and truncation stay explicit.", "default": 3000 }, "maxFilingsPerQuery": { "title": "Maximum filings per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Hard bound on selected output filing candidates per exact query.", "default": 25 }, "maxEvents": { "title": "Maximum unique filing events", "minimum": 1, "maximum": 50, "type": "integer", "description": "Hard dataset-row and pay-per-event result ceiling after global recordId deduplication.", "default": 50 }, "outputSchemaVersion": { "title": "Output schema version", "enum": [ "1.0" ], "type": "string", "description": "Published deterministic dataset contract; only version 1.0 is currently supported.", "default": "1.0" }, "outputMode": { "title": "Output mode", "enum": [ "full", "compact" ], "type": "string", "description": "compact omits the bounded Item 4 prose but preserves status, counts, source, and rule metadata.", "default": "full" }, "incremental": { "title": "Stateless incremental mode", "type": "object", "description": "First run: omit cursor. Later pass SUMMARY.nextCursor unchanged. Exact accession queries are not allowed in incremental mode.", "properties": { "cursor": { "title": "Previous cursor", "description": "Opaque nextCursor from the previous SUMMARY; omit on the first run and never edit it.", "type": "string", "maxLength": 32768, "pattern": "^secowncur1_[A-Za-z0-9_-]+$" }, "overlapHours": { "title": "Overlap hours", "description": "Recheck this many hours before each atomic filing watermark; recent stable record IDs suppress duplicates.", "type": "integer", "editor": "number", "minimum": 0, "maximum": 168 } }, "additionalProperties": false } } }, "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 } } } } } } } } } } ```