{ "openapi": "3.0.1", "info": { "title": "SEC Executive Compensation Scraper: CEO Pay", "description": "Scrape CEO and executive pay from SEC DEF 14A annual meeting filings by ticker or across the market. Get CEO total pay, pay actually received, the average of other executives, CEO pay ratio, median employee pay and shareholder return against peers for each fiscal year. Export to CSV or Excel.", "version": "1.0", "x-build-id": "dP0REixf4BsDq3FO3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parselab~sec-executive-compensation-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parselab-sec-executive-compensation-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/parselab~sec-executive-compensation-scraper/runs": { "post": { "operationId": "runs-sync-parselab-sec-executive-compensation-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/parselab~sec-executive-compensation-scraper/run-sync": { "post": { "operationId": "run-sync-parselab-sec-executive-compensation-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": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000." }, "mode": { "title": "What to collect", "enum": [ "years", "companies" ], "type": "string", "description": "Fiscal years returns one row per company and fiscal year with the pay of the CEO, the pay actually received, the other executives and the shareholder return. Companies returns one row per company with the latest numbers, the CEO pay ratio, totals over the years and the history.", "default": "years" }, "tickers": { "title": "Stock tickers", "type": "array", "description": "Tickers of the companies, for example MSFT, AAPL, JPM. Leave empty together with CIK numbers to read all proxy statements filed in the date range.", "items": { "type": "string" } }, "ciks": { "title": "Company IDs (CIK)", "type": "array", "description": "SEC company numbers, for companies without a ticker.", "items": { "type": "string" } }, "companyNames": { "title": "Company names", "type": "array", "description": "Part of a company name. Used in the market scan (no tickers) to keep only proxy statements of companies whose name contains the text.", "items": { "type": "string" } }, "proxiesPerCompany": { "title": "Proxy statements per company", "minimum": 1, "maximum": 6, "type": "integer", "description": "How many of the latest annual proxy statements to read for each company. One statement covers up to five fiscal years, older statements add the earlier years again with their original numbers.", "default": 1 }, "fiscalYearFrom": { "title": "First fiscal year", "minimum": 2020, "maximum": 2100, "type": "integer", "description": "Keep only fiscal years from this year on, for example 2023." }, "fiscalYearTo": { "title": "Last fiscal year", "minimum": 2020, "maximum": 2100, "type": "integer", "description": "Keep only fiscal years up to this year." }, "minCeoPayUsd": { "title": "Minimum CEO total pay (USD)", "minimum": 0, "type": "integer", "description": "Keep only rows where the CEO total pay of the summary compensation table is at least this much, for example 20000000." }, "minPayRatio": { "title": "Minimum CEO pay ratio", "minimum": 0, "type": "number", "description": "Keep only companies where the CEO earns at least this many times the median employee, for example 300." }, "dateFrom": { "title": "Proxy filed from", "type": "string", "description": "Market scan only. First filing date of proxy statements, YYYY-MM-DD. The default is 45 days ago. Most proxy statements are filed from March to June." }, "dateTo": { "title": "Proxy filed to", "type": "string", "description": "Market scan only. Last filing date, YYYY-MM-DD. The default is today." }, "maxFilingsToScan": { "title": "Max proxy statements to scan", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Safety limit for how many proxy statements are read in a market scan. Each one is a large document.", "default": 300 }, "includeText": { "title": "Include text excerpts", "type": "boolean", "description": "Adds the sentence about the CEO pay ratio and the text about the named executives and the peer group.", "default": true }, "contactEmail": { "title": "Contact email (optional)", "type": "string", "description": "Added to the request header as SEC fair access guidelines recommend. Leave empty if you prefer." } } }, "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 } } } } } } } } } }