{ "openapi": "3.0.1", "info": { "title": "US Stock Trades — House STOCK Act Disclosures", "description": "Extract disclosed US House stock trades from official STOCK Act Periodic Transaction Reports. Returns member, ticker, buy/sell, amount range, dates, delay, and the source PTR PDF. \\$0.005 per trade.", "version": "0.1", "x-build-id": "KCSMQlL2TeTBhKaJm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~us-stock-trades-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-us-stock-trades-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/khadinakbar~us-stock-trades-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-us-stock-trades-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/khadinakbar~us-stock-trades-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-us-stock-trades-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": { "tickers": { "title": "Tickers", "maxItems": 50, "type": "array", "description": "Optional US ticker filters such as AAPL or BRK.B. The Actor still opens the newest PTR PDFs in the selected years, then keeps matching symbols. Leave empty to return every extractable disclosed trade in those filings. This is not a company-name or live tape search.", "items": { "type": "string" } }, "lastName": { "title": "Member last name", "type": "string", "description": "Optional House member last name, for example Alford or Kelly. Case-insensitive contains match against the Clerk index. Leave blank to scan the newest PTR filings from any member. This is not a Senate last-name search." }, "firstName": { "title": "Member first name", "type": "string", "description": "Optional House member first name, for example Mark. Use with lastName to disambiguate common surnames. Leave blank when lastName is enough. This is not a nickname or party filter." }, "filingYears": { "title": "Filing years", "type": "array", "description": "Calendar years of House Clerk disclosure ZIPs to read, for example 2026. Defaults to the current year. Allowed range is 2018 through the current year. This is the year the PTR was filed, not the trade date.", "items": { "type": "integer" }, "default": [ 2026 ] }, "startDate": { "title": "Start date", "type": "string", "description": "Inclusive lower bound as YYYY-MM-DD. Filters PTR filing dates in the Clerk index and transaction dates inside parsed PDFs. Example: 2026-01-01. Leave blank for no lower bound. This is not a market session or settlement date." }, "endDate": { "title": "End date", "type": "string", "description": "Inclusive upper bound as YYYY-MM-DD. Pair with startDate. Example: 2026-09-10. Leave blank for no upper bound. Filing dates come from the Clerk index; trade dates come from the PTR PDF." }, "transactionType": { "title": "Transaction type", "enum": [ "all", "purchase", "sale", "exchange" ], "type": "string", "description": "Keep purchases, sales, exchanges, or all STOCK Act transaction codes. Default all. Partial sales and partial purchases stay inside purchase or sale. This is the PTR P/S/E code, not a broker order type.", "default": "all" }, "maxFilings": { "title": "Max PTR filings", "minimum": 1, "maximum": 40, "type": "integer", "description": "How many newest matching Periodic Transaction Report PDFs to open. Default 4, maximum 40. Each filing can contain many trades. Lower this to bound runtime. This is a filing cap, not the billed trade-row cap.", "default": 4 }, "maxResults": { "title": "Max trades", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard cap on billed dataset rows. Default 10, maximum 200. Each saved trade costs $0.005. Use this to bound spend. This is not the number of PTR PDFs opened.", "default": 10 } } }, "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 } } } } } } } } } }