{ "openapi": "3.0.1", "info": { "title": "Congress Stock Trades Data API", "description": "Query US House and Senate STOCK Act stock trades as structured rows for MCP and APIs. Filter by politician, ticker, chamber, date range, and buy/sell. $0.008 per trade row.", "version": "0.1", "x-build-id": "1keRa8rPRkHr1g1x1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~congress-stock-trades-data-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-congress-stock-trades-data-api", "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~congress-stock-trades-data-api/runs": { "post": { "operationId": "runs-sync-khadinakbar-congress-stock-trades-data-api", "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~congress-stock-trades-data-api/run-sync": { "post": { "operationId": "run-sync-khadinakbar-congress-stock-trades-data-api", "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": { "politicianNames": { "title": "Politician names", "maxItems": 10, "type": "array", "description": "Optional member name filters such as Pelosi or Kean. Case-insensitive contains match against the filer display name. Leave empty to return trades from any member in the recent public feed. This is not a party or committee filter.", "items": { "type": "string" } }, "tickers": { "title": "Tickers", "maxItems": 20, "type": "array", "description": "Optional US ticker filters such as AAPL or AMCR. Leave empty to keep every disclosed symbol. With enrichDetail enabled, matching ticker pages are also loaded for deeper history. This is not a company-name search.", "items": { "type": "string" } }, "chamber": { "title": "Chamber", "enum": [ "all", "House", "Senate" ], "type": "string", "description": "Keep House trades, Senate trades, or both. Default all. Use Senate when you need senator disclosures that official Senate eFD search often blocks for plain HTTP clients.", "default": "all" }, "transactionType": { "title": "Transaction type", "enum": [ "all", "purchase", "sale", "exchange" ], "type": "string", "description": "Keep purchases, sales, exchanges, or all disclosed transaction types. Partial sales and full sales both match sale. This is the STOCK Act disclosure type, not a broker order type.", "default": "all" }, "startDate": { "title": "Start date", "type": "string", "description": "Inclusive lower bound on transaction date as YYYY-MM-DD. Example: 2026-07-01. Leave blank for no lower bound. This filters trade dates, not disclosure filing dates." }, "endDate": { "title": "End date", "type": "string", "description": "Inclusive upper bound on transaction date as YYYY-MM-DD. Pair with startDate. Leave blank for no upper bound." }, "maxResults": { "title": "Max trades", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard cap on billed dataset rows. Default 25, maximum 200. Each saved trade costs $0.008. Use this to bound spend for MCP and API callers.", "default": 25 }, "enrichDetail": { "title": "Enrich politician or ticker pages", "type": "boolean", "description": "When true and politicianNames or tickers are set, also load matching Quiver politician or ticker pages for deeper history beyond the recent feed. Default false keeps the run on the recent public list only.", "default": 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 } } } } } } } } } }