# Congressional Stock Trades Scraper (`sheshinmcfly/congress-stock-trades-scraper`) Actor Extract every stock trade disclosed by U.S. House members under the STOCK Act: politician, ticker, transaction type, dates, amount range, sub-holding, and disclosure-delay signals. Sourced from the official House Clerk bulk data, no login or API key needed. - **URL**: https://apify.com/sheshinmcfly/congress-stock-trades-scraper.md - **Developed by:** [Sheshinmcfly](https://apify.com/sheshinmcfly) (community) - **Categories:** News, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 trade records 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## Congressional Stock Trades Scraper Extract every stock trade disclosed by **U.S. House of Representatives members** under the STOCK Act — ticker, transaction type, dates, amount range, sub-holding, and computed disclosure-delay signals. Sourced directly from the official House Clerk bulk data. No login, no API key, no PDF wrangling required. ### What data do you get? | Field | Type | Example | |---|---|---| | filerName, state, district | string | `Hon. Mark Alford`, `MO`, `04` | | ticker, assetName, assetType | string | `AMZN`, `Amazon.com, Inc. - Common Stock`, `ST` | | transactionType | string | `S (partial)`, `P`, `E` | | transactionDate, notificationDate, filingDate | string | disclosure timeline | | amountLow, amountHigh, amountMidpoint | number | `$1,001 - $15,000` → `1001`, `15000`, `8000.5` | | **disclosureDelayDays, lateFilingFlag** | number, boolean | days between trade and disclosure; STOCK Act requires ≤45 | | ownerCode, subHoldingOf, location | string | filer / spouse / joint, brokerage or trust name | | pdfUrl | string | link to the original signed filing | 23 fields per transaction, one row per disclosed trade. ### How to use 1. Open the actor and (optionally) set a filing year and max results 2. Click **Start** 3. Download results as JSON, CSV, or Excel ### Use cases - **Copy-trading research**: track which stocks members of Congress are buying and selling - **Compliance monitoring**: flag late disclosures — the STOCK Act requires filing within 45 days of a trade - **Journalism & transparency**: cross-reference committee assignments with trading activity - **Quant/alt-data pipelines**: feed disclosed trades into a signal alongside price and fundamentals data - **Academic research**: build datasets on political trading patterns over time ### Input parameters ```json { "year": 2026, "maxResults": 1000 } ```` | Parameter | Type | Required | Description | |---|---|---|---| | `year` | integer | No | Filing year to pull. Defaults to the current year. | | `maxResults` | integer | No | Maximum trade records to return. Default 1000. | | `proxyConfiguration` | object | No | Optional — the actor works reliably without a proxy in most cases. | ### Example output (JSON) ```json { "docId": "20034201", "pdfUrl": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20034201.pdf", "filerName": "Hon. Mark Alford", "state": "MO", "district": "04", "ownerCode": null, "assetName": "Amazon.com, Inc. - Common Stock", "ticker": "AMZN", "assetType": "ST", "transactionType": "S (partial)", "transactionDate": "03/16/2026", "notificationDate": "03/16/2026", "amountLow": 1001, "amountHigh": 15000, "amountMidpoint": 8000.5, "filingStatus": "New", "subHoldingOf": "Putnam Investments", "disclosureDelayDays": 0, "lateFilingFlag": false, "extractedAt": "2026-07-09T11:00:00.000Z" } ``` ### Performance Returns hundreds of trade records per run in well under a minute, covering every disclosed trade for the requested year. ### Pricing Pay-per-event: **$2.00 per 1,000 trade records** ($0.002 per trade). Every Apify account gets $5 in free usage per month, enough to try this actor at no cost. ### Related actors - **[SEC EDGAR Scraper](https://apify.com/sheshinmcfly/sec-edgar-scraper)** — company filings, Form 4 insider trades, XBRL financials and 13F fund holdings. - **[Zacks Rank Stock Scraper](https://apify.com/sheshinmcfly/zacks-rank-scraper)** — Zacks Rank (1-5 rating) plus a full quote snapshot for any US stock ticker. - **[FinViz Stock Screener](https://apify.com/sheshinmcfly/finviz-stock-screener)** — technical screeners with 61 fundamental/technical fields per stock. - **[Financial Calendar Scraper](https://apify.com/sheshinmcfly/financial-calendar-scraper)** — earnings, dividends, splits and IPO calendars. - **[Dividend & ETF Scraper](https://apify.com/sheshinmcfly/dividend-etf-scraper)** — full dividend history and ETF holdings. - **[ATS Job Board Scraper](https://apify.com/sheshinmcfly/ats-job-board-scraper)** — job postings from any company Greenhouse, Lever, or Ashby career page, unified in one schema. ### FAQ **Which chamber does this cover?** U.S. House of Representatives Periodic Transaction Reports (PTRs) — the actual disclosed stock trades under the STOCK Act, not annual holdings summaries. **Does it cover every member, or do I need to search by name?** Every member — the actor pulls the House Clerk's official bulk filing index directly, so coverage isn't limited to whichever names you happen to search for. **Why is `ticker` empty on some records?** Members disclose more than stocks — Treasury notes, municipal bonds, and private funds/equity are included too, and those don't have a stock ticker (bonds carry a CUSIP identifier instead, included in `assetName`). `assetType` tells you what kind of asset each record is (`ST` = stock, `GS` = government security, etc.). **What does `disclosureDelayDays` mean?** The number of days between the trade date and the notification (filing) date. The STOCK Act requires disclosure within 45 days; `lateFilingFlag` is `true` when that threshold is exceeded. **How often is the data updated?** The House Clerk publishes filings on a rolling basis; each run pulls the latest bulk index for the requested year. ### Keywords congress stock trades, STOCK Act, congressional trading, insider trading, financial disclosure, periodic transaction report, politician stock trades, government transparency, house of representatives, copy trading ### Legal Disclaimer This actor extracts publicly available financial disclosure data published by the U.S. House of Representatives. Users are solely responsible for ensuring their use of this data complies with applicable laws. This is not financial advice. ### Changelog - **v1.1 (2026-07-09)** — FAQ clarification on non-equity asset records (bonds, private funds). - **v1.0 (2026-07-09)** — Initial release: House STOCK Act trade disclosures, 23 fields per transaction, disclosure-delay signals, no login required. # Actor input Schema ## `year` (type: `integer`): Disclosure year to pull from the official House Clerk bulk index. Defaults to the current year. ## `maxResults` (type: `integer`): Maximum number of individual trade records to return. ## `proxyConfiguration` (type: `object`): Optional — the actor works reliably without a proxy in most cases. ## Actor input object example ```json { "maxResults": 1000, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `dataset` (type: `string`): All extracted trade records stored in the default dataset. # 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 = { "maxResults": 1000 }; // Run the Actor and wait for it to finish const run = await client.actor("sheshinmcfly/congress-stock-trades-scraper").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 = { "maxResults": 1000 } # Run the Actor and wait for it to finish run = client.actor("sheshinmcfly/congress-stock-trades-scraper").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 '{ "maxResults": 1000 }' | apify call sheshinmcfly/congress-stock-trades-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sheshinmcfly/congress-stock-trades-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Congressional Stock Trades Scraper", "description": "Extract every stock trade disclosed by U.S. House members under the STOCK Act: politician, ticker, transaction type, dates, amount range, sub-holding, and disclosure-delay signals. Sourced from the official House Clerk bulk data, no login or API key needed.", "version": "0.1", "x-build-id": "PLsJVAJeeEWByh4Xa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sheshinmcfly~congress-stock-trades-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sheshinmcfly-congress-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/sheshinmcfly~congress-stock-trades-scraper/runs": { "post": { "operationId": "runs-sync-sheshinmcfly-congress-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/sheshinmcfly~congress-stock-trades-scraper/run-sync": { "post": { "operationId": "run-sync-sheshinmcfly-congress-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": { "year": { "title": "Filing year", "minimum": 2012, "type": "integer", "description": "Disclosure year to pull from the official House Clerk bulk index. Defaults to the current year." }, "maxResults": { "title": "Max trade records", "minimum": 1, "type": "integer", "description": "Maximum number of individual trade records to return.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional — the actor works reliably without a proxy in most cases.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```